class documentation
        
        class Contents(Directive): (source)
Constructor: Contents(name, arguments, options, content, ...)
Table of contents.
The table of contents is generated in two passes: initial parse and transform. During the initial parse, a 'pending' element is generated which acts as a placeholder, storing the TOC title and any options internally. At a later stage in the processing, the 'pending' element is replaced by a 'topic' element, a title and the table of contents proper.
| Method | backlinks | 
    Undocumented | 
| Method | run | 
    Undocumented | 
| Class Variable | backlinks | 
    Undocumented | 
| Class Variable | final | 
    May the final argument contain whitespace? | 
| Class Variable | option | 
    Mapping of option names to validator functions. | 
| Class Variable | optional | 
    Number of optional arguments after the required arguments. | 
              Inherited from Directive:
            
| Method | __init__ | 
    Undocumented | 
| Method | add | 
    Append self.options['name'] to node['names'] if it exists. | 
| Method | assert | 
    Throw an ERROR-level DirectiveError if the directive doesn't have contents. | 
| Method | debug | 
    Undocumented | 
| Method | directive | 
    Return a DirectiveError suitable for being thrown as an exception. | 
| Method | error | 
    Undocumented | 
| Method | info | 
    Undocumented | 
| Method | severe | 
    Undocumented | 
| Method | warning | 
    Undocumented | 
| Class Variable | has | 
    May the directive have content? | 
| Class Variable | required | 
    Number of required directive arguments. | 
| Instance Variable | arguments | 
    Undocumented | 
| Instance Variable | block | 
    Undocumented | 
| Instance Variable | content | 
    Undocumented | 
| Instance Variable | content | 
    Undocumented | 
| Instance Variable | lineno | 
    Undocumented | 
| Instance Variable | name | 
    Undocumented | 
| Instance Variable | options | 
    Undocumented | 
| Instance Variable | state | 
    Undocumented | 
| Instance Variable | state | 
    Undocumented |