* Update information about jsondoc/jsondoc2
Manual was missing information about jsondoc2 which made it seem like
it didn't exist at all. This commit adds mention of the jsondoc2
command along with an example.
* Renamed jsondoc2 similar to doc2 and updated docs
doc2 was recently renamed to doc while doc was renamed to doc0. This
commits renames jsondoc to jsondoc2 and jsondoc2 to jsondoc0 to behave
tha same way. The documentation for doc/jsondoc was also lagging behind
this change which has also been fixed. I interpreted this as a soft
deprecation of doc and jsondoc and therefore removed them from the
auto-complete lists.
`writeDepsFile()` does not list files which were included with the
`include` statement, e.g, with:
import file1
include file2
`file1` will be written to the deps file, while `file2` would not.
Fix this by modifying `writeDepsFile()` to write included files as well.
Now, both `file1` and `file2` in the above example will be written to
the deps file.
The "genDepend" command was previously taught how to generate a "deps"
file in 4910a87c6 (gendepend improvements; refs #5144). Such a deps file
is useful in integrating the Nim compiler with an external build system
or watch daemon, such that it's possible to only run the Nim compiler
when any of the source files are modified.
It's also useful to generate the deps file in the nimcache directory
during C compilation, without needing to re-run the compilation passes
with "genDepend". This would thus reduce overall project build times.
This solves two issues:
1. Some notes were enabled explicitly for some verbosity levels, so
--hintName:on has no effect if verbosity level was too low.
2. Verbosity level for notes is not longer scattered across the source code,
instead if now lives in msgs.nim NotesVerbosity array
3. Individual note settings have stronger effect than verbosity setting,
so --hintName:off will disable hint regardless of high verbosity setting,
and vice-versa --hintName:on will enable hint even on low verbosity setting.