remove all mentions of doc2, jsondoc2 (except 1 mentioning the alias) (#15683)
This commit is contained in:
parent
70a1c42542
commit
13b1b19a83
9 changed files with 15 additions and 15 deletions
|
|
@ -73,7 +73,7 @@ Advanced options:
|
|||
--clibdir:DIR modify the linker library search path
|
||||
--clib:LIBNAME link an additional C library
|
||||
(you should omit platform-specific extensions)
|
||||
--project document the whole project (doc2)
|
||||
--project document the whole project (doc)
|
||||
--docRoot:path `nim doc --docRoot:/foo --project --outdir:docs /foo/sub/main.nim`
|
||||
generates: docs/sub/main.html
|
||||
if path == @pkg, will use nimble file enclosing dir
|
||||
|
|
@ -85,7 +85,7 @@ Advanced options:
|
|||
--docCmd:cmd if `cmd == skip`, skips runnableExamples
|
||||
else, runs runnableExamples with given options, e.g.:
|
||||
`--docCmd:"-d:foo --threads:on"`
|
||||
--docSeeSrcUrl:url activate 'see source' for doc and doc2 commands
|
||||
--docSeeSrcUrl:url activate 'see source' for doc command
|
||||
(see doc.item.seesrc in config/nimdoc.cfg)
|
||||
--docInternal also generate documentation for non-exported symbols
|
||||
--lineDir:on|off generation of #line directive on|off
|
||||
|
|
|
|||
|
|
@ -193,7 +193,7 @@ Index switch
|
|||
------------
|
||||
|
||||
::
|
||||
nim doc2 --index:on filename.nim
|
||||
nim doc --index:on filename.nim
|
||||
|
||||
This will generate an index of all the exported symbols in the input Nim
|
||||
module, and put it into a neighboring file with the extension of ``.idx``. The
|
||||
|
|
@ -210,7 +210,7 @@ See source switch
|
|||
-----------------
|
||||
|
||||
::
|
||||
nim doc2 --git.url:<url> filename.nim
|
||||
nim doc --git.url:<url> filename.nim
|
||||
|
||||
With the ``git.url`` switch the *See source* hyperlink will appear below each
|
||||
documented item in your source code pointing to the implementation of that
|
||||
|
|
@ -262,8 +262,8 @@ HTML anchor generation
|
|||
When you run the ``rst2html`` command, all sections in the RST document will
|
||||
get an anchor you can hyperlink to. Usually, you can guess the anchor lower
|
||||
casing the section title and replacing spaces with dashes, and in any case, you
|
||||
can get it from the table of contents. But when you run the ``doc`` or ``doc2``
|
||||
commands to generate API documentation, some symbol get one or two anchors at
|
||||
can get it from the table of contents. But when you run the ``doc``
|
||||
command to generate API documentation, some symbol get one or two anchors at
|
||||
the same time: a numerical identifier, or a plain name plus a complex name.
|
||||
|
||||
The numerical identifier is just a random number. The number gets assigned
|
||||
|
|
|
|||
|
|
@ -78,7 +78,7 @@ Whenever an example of usage would be helpful to the user, you should include on
|
|||
doAssert addThree(3, 125, 6) == -122
|
||||
result = x +% y +% z
|
||||
|
||||
The commands ``nim doc`` and ``nim doc2`` will then correctly syntax highlight the Nim code within the documentation.
|
||||
The command ``nim doc`` will then correctly syntax highlight the Nim code within the documentation.
|
||||
|
||||
Types
|
||||
-----
|
||||
|
|
|
|||
|
|
@ -516,7 +516,7 @@ can be read in the `Nim Backend Integration document <backends.html>`_.
|
|||
Nim documentation tools
|
||||
=======================
|
||||
|
||||
Nim provides the `doc`:idx: and `doc2`:idx: commands to generate HTML
|
||||
Nim provides the `doc`:idx: command to generate HTML
|
||||
documentation from ``.nim`` source files. Only exported symbols will appear in
|
||||
the output. For more details `see the docgen documentation <docgen.html>`_.
|
||||
|
||||
|
|
|
|||
|
|
@ -457,7 +457,7 @@ If you want to add the ``{.raises.}`` pragma to existing code, the compiler can
|
|||
also help you. You can add the ``{.effects.}`` pragma statement to your proc and
|
||||
the compiler will output all inferred effects up to that point (exception
|
||||
tracking is part of Nim's effect system). Another more roundabout way to
|
||||
find out the list of exceptions raised by a proc is to use the Nim ``doc2``
|
||||
find out the list of exceptions raised by a proc is to use the Nim ``doc``
|
||||
command which generates documentation for a whole module and decorates all
|
||||
procs with the list of raised exceptions. You can read more about Nim's
|
||||
`effect system and related pragmas in the manual <manual.html#effect-system>`_.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue