Specify the document title as metadata (not part of the document body). Overrides a document-provided title. There is no default.

Include a "Generated by Docutils" credit and link at the end of the document.

Do not include a generator credit.

Include the date at the end of the document (UTC).

Include the time & date at the end of the document (UTC).

Do not include a datestamp of any kind.

Include a "View document source" link (relative to destination).

Use the supplied <URL> verbatim for a "View document source" link; implies --source-link.

Do not include a "View document source" link.

Enable backlinks from section headers to table of contents entries. This is the default.

Enable backlinks from section headers to the top of the table of contents.

Disable backlinks to the table of contents.

Enable backlinks from footnotes and citations to their references. This is the default.

Disable backlinks from footnotes and citations.

Enable Docutils section numbering (default: enabled).

Disable Docutils section numbering (default: enabled).

Remove comment elements from the document tree (default: leave them).

Leave comment elements in the document tree (this is the default).

Set verbosity threshold; report system messages at or higher than <level> (by name or number: "info" or "1", warning/2, error/3, severe/4; also, "none" or "5"). Default is 2 (warning).

Report all system messages, info-level and higher. (Same as "--report=info".)

Do not report any system messages. (Same as "-- report=none".)

Set the threshold (<level>) at or above which system messages are converted to exceptions, halting execution immediately by exiting (or propagating the exception if --traceback set). Levels as in --report. Default is 4 (severe).

Same as "--halt=info": halt processing at the slightest problem.

Enable a non-zero exit status for normal exit if non- halting system messages (at or above <level>) were generated. Levels as in --report. Default is 5 (disabled). Exit status is the maximum system message level plus 10 (11 for INFO, etc.).

Report debug-level system messages and generate diagnostic output.

Do not report debug-level system messages or generate diagnostic output.

Send the output of system messages (warnings) to <file>.

Enable Python tracebacks when halt-level system messages and other exceptions occur. Useful for debugging, and essential for issue reports.

Disable Python tracebacks when errors occur; report just the error instead. This is the default.

Specify the encoding of input text. Default is locale-dependent. Optionally also specify the error handler for undecodable characters, after a colon (":"); default is "strict". (See "--intput-encoding- error-handler".)

Specify the error handler for undecodable characters in the input. Acceptable values include "strict", "ignore", and "replace". Default is "strict". Usually specified as part of --input-encoding.

Specify the text encoding for output. Default is UTF-8. Optionally also specify the error handler for unencodable characters, after a colon (":"); default is "strict". (See "--output-encoding-error-handler".)

Specify the error handler for unencodable characters in the output. Acceptable values include "strict", "ignore", "replace", "xmlcharrefreplace", and "backslashreplace" (in Python 2.3+). Default is "strict". Usually specified as part of --output- encoding.

Specify the text encoding for error output. Default is ASCII. Optionally also specify the error handler for unencodable characters, after a colon (":"); default is "backslashreplace". (See "--output- encoding-error-handler".)

Specify the error handler for unencodable characters in error output. See --output-encoding-error-handler for acceptable values. Default is "backslashreplace". Usually specified as part of --error-encoding.

Specify the language of input text (ISO 639 2-letter identifier). Default is "en" (English).

Write dependencies (caused e.g. by file inclusions) to <file>. Useful in conjunction with programs like "make".

Read configuration settings from <file>, if it exists.

Show this program's version number and exit.

Show this help message and exit.

Recognize and link to standalone PEP references (like "PEP 258").

Base URL for PEP references (default "http://www.python.org/peps/").

Recognize and link to standalone RFC references (like "RFC 822").

Base URL for RFC references (default "http://www.faqs.org/rfcs/").

Set number of spaces for tab expansion (default 8).

Remove spaces before footnote references.

Leave spaces before footnote references.

Disable directives that insert the contents of external file ("include" & "raw"); replaced with a "warning" system message.

Enable directives that insert the contents of external file ("include" & "raw"). Enabled by default.

Disable the "raw" directives; replaced with a "warning" system message.

Enable the "raw" directive. Enabled by default.

Disable the promotion of a lone top-level section title to document title (and subsequent section title to document subtitle promotion; enabled by default).

Disable the bibliographic field list transform (enabled by default).

Activate the promotion of lone subsection titles to section subtitles (disabled by default).

Deactivate the promotion of lone subsection titles.

Specify a stylesheet URL, used verbatim. Overrides --stylesheet-path.

Specify a stylesheet file, relative to the current working directory. The path is adjusted relative to the output HTML file. Overrides --stylesheet. Default: "../../../../lib/python2.4/site- packages/docutils/writers/html4css1/html4css1.css"

Embed the stylesheet in the output HTML file. The stylesheet file must be accessible during processing (--stylesheet-path is recommended). This is the default.

Link to the stylesheet in the output HTML file. Default: embed the stylesheet, do not link to it.

Specify the initial header level. Default is 1 for "<h1>". Does not affect document title & subtitle (see --no-doc-title).

Specify the maximum width (in characters) for one- column field names. Longer field names will span an entire row of the table used to render the field list. Default is 14 characters. Use 0 for "no limit".

Specify the maximum width (in characters) for options in option lists. Longer options will span an entire row of the table used to render the option list. Default is 14 characters. Use 0 for "no limit".

Format for footnote references: one of "superscript" or "brackets". Default is "brackets".

Format for block quote attributions: one of "dash" (em-dash prefix), "parentheses"/"parens", or "none". Default is "dash".

Remove extra vertical whitespace between items of "simple" bullet lists and enumerated lists. Default: enabled.

Disable compact simple bullet and enumerated lists.

Remove extra vertical whitespace between items of simple field lists. Default: enabled.

Disable compact simple field lists.

Omit the XML declaration. Use with caution.

Obfuscate email addresses to confuse harvesters while still keeping email links usable with standards- compliant browsers.