This writer uses the following output defines:

-W depth=<positive_integer> Specify the depth of TOC, with 1 corresponding to the top level sections (default is 99). -W exclude-top=<0|1> Specify whether the top level section headers should be excluded from the TOC (default is 0, do not exclude). This has no effect if ``-W symbol='<char>'`` is present. -W file-suffix=<suffix> Specify a file suffix to be used as the targets of TOC entries. It is either a string or a comma-separated list of "ext1=ext2" pairs where any file with extension ext1 has it mapped to ext2. This option allows generating a table of contents for multiple documents where more than one extension is needed (e.g., .html and .xhtml). Default is "html". -W filename-ext=<ext> Specify an extension to the filename, (e.g. "_main") so the file location of targets becomes <file><ext>.<suffix> (default is ""). -W include-noheader=<0|1> If set to 1, the writer includes in the TOC the document source bare name for any document that does not have a header (default is 0, do not include). -W parent-role=<role_name> If specified, items which have sublists are created as interpreted text with the given role. The role must be defined elsewhere. -W symbol=<header_marking_character> If specified, the writer uses the symbol to create additional headers for the document titles. (default is "", no headers created). This output define overwrites ``-W exclude_top=1``. If a document does not have a title, use the document source bare name instead. -W top-in-list=<0|1> Specify whether the top level section headers should be part of the list with other section headers (default is 0, top level header being outside of the list). This has no effect if the top level headers are excluded. =end Description =end reST