mirrors/Nim
1
0
Fork 0
mirror of https://github.com/nim-lang/Nim.git synced 2025-12-28 17:04:41 +00:00
Code Issues Packages Projects Releases Wiki Activity

fixes #8215; remove reference to old doc command which was deprecated (#8418)

Browse Source
This commit is contained in:
Timothee Cour
2018-08-05 03:15:40 -07:00
committed by Andreas Rumpf
parent c57e320c94
commit baa77387d7
2 changed files with 6 additions and 25 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
doc/docgen.rst
View File

@@ -97,24 +97,9 @@ Partial Output::
proc helloWorld(times: int) {.raises: [], tags: [].}
...
The full output can be seen here: `docgen_sample2.html <docgen_sample2.html>`_.
The older version of the ``doc`` command, now renamed ``doc0`` runs before
semantic checking which means it lacks some of the things ``doc`` will output.
The ``doc0`` command::
nim doc0 sample
Partial Output::
...
proc helloWorld*(times: int)
...
Output can be viewed in full here: `docgen_sample.html <docgen_sample.html>`_.
As you can see, the tool has extracted less information than what the ``doc``
command provides, such as pragmas attached implicitly by the compiler. This type
of information is not available from looking at the AST (Abstract Syntax Tree)
prior to semantic checking, which is why ``doc0`` doesn't show it.
The full output can be seen here: `docgen_sample.html <docgen_sample.html>`_.
It runs after semantic checking, and includes pragmas attached implicitly by the
compiler.
JSON

10
tools/nimweb.nim
View File

@@ -303,14 +303,10 @@ proc mexec(cmds: openarray[string], processors: int) =
proc buildDocSamples(c: var TConfigData, destPath: string) =
## Special case documentation sample proc.
##
## The docgen sample needs to be generated twice with different commands, so
## it didn't make much sense to integrate into the existing generic
## documentation builders.
const src = "doc"/"docgen_sample.nim"
## TODO: consider integrating into the existing generic documentation builders
## now that we have a single `doc` command.
exec(findNim(c) & " doc $# -o:$# $#" %
[c.nimArgs, destPath / "docgen_sample.html", src])
exec(findNim(c) & " doc2 $# -o:$# $#" %
[c.nimArgs, destPath / "docgen_sample2.html", src])
[c.nimArgs, destPath / "docgen_sample.html", "doc" / "docgen_sample.nim"])
proc pathPart(d: string): string = splitFile(d).dir.replace('\\', '/')