| Commit message (Collapse) | Author | Age | Files | Lines |
| |
|
|
|
| |
Fix several reference errors throughout the documentation and set
``nitpick_ignore`` in ``doc/conf.py``.
|
| |
|
| |
Make --jobs a synonym for -j
|
| |
|
| |
Add the missing default arguments to two CLI flags, ``-l`` and ``-d``
|
| |
|
| |
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
|
| | |
|
| |
|
|
|
| |
Using "console" language is better for the console example (including
command-line prompt)
|
| | |
|
| | |
|
| |
|
|
| |
The moved sentence clearly belongs to the discussion of the builders.
|
| |
|
|
|
|
| |
To describe the purpose more accurately, the `master_doc` is now renamed
to `root_doc`. The old name is still available. But it is recommeneded
to use new one from now on.
|
| | |
|
| | |
|
| |\
| |
| | |
Fix sphinx-autogen commandline in examples
|
| | | |
|
| |\ \
| |/ |
|
| | | |
|
| |/
|
|
| |
#6674
Nixing the comma in `EXCLUDE PATTERN, ...` because it's not supposed to be there. See the issue for the research.
|
| | |
|
| | |
|
| |
|
|
|
|
|
|
|
|
| |
The make.bat_t and make.bat.new_t templates now pass %O% as well as
%SPHINXOPTS% to `sphinx-build`, in parity with Makefile.new_t.
The sphinx-build documentation page was updated to explicitly note
$(O) and %O% as shortcut variables.
Closes #6323, per the comment thread discussion.
|
| | |
|
| | |
|
| | |
|
| |\ |
|
| | |
| |
| |
| | |
Fix: #5234
|
| | |
| |
| |
| | |
warnings
|
| | |
| |
| |
| |
| |
| |
| | |
This is placed in a directory as this document will eventually be split
up. However, this is not the day to do this.
Signed-off-by: Stephen Finucane <stephen@that.guru>
|
| | | |
|
| |\ \
| |/ |
|
| | | |
|
| | | |
|
| |\ \
| |/ |
|
| | | |
|
| | |
| |
| |
| |
| |
| |
| |
| |
| | |
The signature for the 'sphinx-apidoc' call differs between the man page
and the output of 'sphinx-apidoc --help'. Resolve this by considering
the 'sphinx-apidoc --help' output the canonical reference.
Signed-off-by: Stephen Finucane <stephen@that.guru>
Fixes: #4451
|
| |/ |
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
Add docs for '--module-first' option and 'SPHINX_APIDOC_OPTIONS'
environment variable. Per the closest thing we have to official man page
guidelines [1]:
ENVIRONMENT
lists all environment variables that affect the program or function
and how they affect it.
[1] https://linux.die.net/man/7/man-pages
Signed-off-by: Stephen Finucane <stephen@that.guru>
Fixes #2250
|
| | |
|
| |
|
|
|
|
|
|
|
|
|
|
| |
Indeed, if latex_engine is not appropriately set, the ``make latexpdf``
then fails because the Makefile in latex build repertory is the one for
pdflatex, not platex+dvipdfmx.
Besides, if language is 'ja', then latexpdf automatically uses the
platex latex_engine, hence the platex/dvipdfmx pipeline, and latexpdfja
is not needed.
For now, only removing documentation.
|
| | |
|
| | |
|
| |
|
|
|
|
|
| |
It's 'py:mod', not 'py:module'. I don't know why this wasn't caught by
Sphinx itself.
Signed-off-by: Stephen Finucane <stephen@that.guru>
|
| | |
|
| | |
|
| | |
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
Per the closest thing we have to official man page guidelines [1]:
Use of an AUTHORS section is strongly discouraged. Generally, it is
better not to clutter every page with a list of (over time potentially
numerous) authors; if you write or significantly amend a page, add a
copyright notice as a comment in the source file.
We already do a good job of tracking authors in the AUTHORS file, so we
can remove this.
[1] https://linux.die.net/man/7/man-pages
Signed-off-by: Stephen Finucane <stephen@that.guru>
|
| |
|
|
|
|
| |
This wasn't documented in depth anywhere, so do just that.
Signed-off-by: Stephen Finucane <stephen@that.guru>
|
| |
|
|
|
|
|
| |
This contains no useful information at this point. Better to simply drop
it.
Signed-off-by: Stephen Finucane <stephen@that.guru>
|
| |
|
|
|
|
|
| |
This man page wasn't making full use of Sphinx's own features. Update it
to do so, and remove the duplicated information from 'invocation'.
Signed-off-by: Stephen Finucane <stephen@that.guru>
|
| |
|
|
|
|
|
| |
This man page wasn't making full use of Sphinx's own features. Update it
to do so, and remove the duplicated information from 'invocation'.
Signed-off-by: Stephen Finucane <stephen@that.guru>
|
| |
|
|
|
|
|
| |
This man page wasn't making full use of Sphinx's own features. Update it
to do so, and remove the duplicated information from 'invocation'.
Signed-off-by: Stephen Finucane <stephen@that.guru>
|