class documentation
class Cmdoption(ObjectDescription[
Description of a command-line option (.. option).
Method | add |
Add cross-reference IDs and entries to self.indexnode, if applicable. |
Method | handle |
Transform an option description into RST nodes. |
Method | make |
Generate old styled node_id for cmdoption. |
Inherited from ObjectDescription
:
Method | after |
Called after parsing content. Used to reset information about the current directive context on the build environment. |
Method | before |
Called before parsing content. Used to set information about the current directive context on the build environment. |
Method | get |
Undocumented |
Method | get |
Retrieve the signatures to document from the directive arguments. By default, signatures are given as arguments, one per line. |
Method | run |
Main directive entry function, called by docutils upon encountering the directive. |
Method | transform |
Called after creating the content through nested parsing, but before the ``object-description-transform`` event is emitted, and before the info-fields are transformed. Can be used to manipulate the content. |
Class Variable | doc |
Undocumented |
Class Variable | final |
Undocumented |
Class Variable | has |
Undocumented |
Class Variable | option |
Undocumented |
Class Variable | optional |
Undocumented |
Class Variable | required |
Undocumented |
Instance Variable | domain |
Undocumented |
Instance Variable | indexnode |
Undocumented |
Instance Variable | names |
Undocumented |
Instance Variable | objtype |
Undocumented |
Method | _object |
Returns a tuple of strings, one entry for each part of the object's hierarchy (e.g. ``('module', 'submodule', 'Class', 'method')``). The returned tuple is used to properly nest children within parents in the table of contents, and can also be used within the :py:meth:`_toc_entry_name` method. |
Method | _toc |
Returns the text of the table of contents entry for the object. |
Instance Variable | _doc |
Undocumented |
Inherited from SphinxDirective
(via ObjectDescription
):
Method | get |
Get current location info for logging. |
Method | get |
Get source and line number. |
Method | set |
Set source and line number to the node. |
Property | config |
Reference to the :class:`.Config` object. |
Property | env |
Reference to the :class:`.BuildEnvironment` object. |
Add cross-reference IDs and entries to self.indexnode, if applicable. *name* is whatever :meth:`handle_signature()` returned.
Parameters | |
firstname:str | Undocumented |
sig:str | Undocumented |
signode:desc_signature | Undocumented |
Transform an option description into RST nodes.
Parameters | |
sig:str | Undocumented |
signode:desc_signature | Undocumented |
Returns | |
str | Undocumented |