Georg Brandl  committed c5ce9a2

Closes #1076: document new sphinx-build options.

  • Participants
  • Parent commits aebaf74
  • Branches default

Comments (0)

Files changed (1)

File doc/invocation.rst

    Do not emit colored output.  (On Windows, colored output is disabled in any
+.. option:: -v
+   Increase verbosity.  This option can be given up to three times to get more
+   debug output.  It implies :option:`-T`.
+   .. versionadded:: 1.2
 .. option:: -q
    Do not output anything on standard output, only write warnings and errors to
    Turn warnings into errors.  This means that the build stops at the first
    warning and ``sphinx-build`` exits with exit status 1.
+.. option:: -T
+   Display the full traceback when an unhandled exception occurs.  Otherwise,
+   only a summary is displayed and the traceback information is saved to a file
+   for further analysis.
+   .. versionadded:: 1.2
 .. option:: -P
    (Useful for debugging only.)  Run the Python debugger, :mod:`pdb`, if an
    unhandled exception occurs while building.
+.. option:: -h, --help, --version
+   Display usage summary or Sphinx version.
+   .. versionadded:: 1.2
 You can also give one or more filenames on the command line after the source and
 build directories.  Sphinx will then try to build only these output files (and