Documentation set written to multiple structured files.
Parameters
Adds no additional parameters not understood by DocSet.
Do not use multiple lines in the class docstring, since it shows up as
part of the generated help message for the app and multiple lines throws
off the formatting.
Methods
|
|
|
|
__init__
|
__init__ ( self, **args )
|
|
_writeBaseClassNames
|
_writeBaseClassNames (
self,
parent,
cinfo,
output,
indent=0,
)
Output the base class hierarchy for the given class.
Arguments
-
parent
- info about class parent (module, class)
-
cinfo
- class info
-
output
- current output file object
|
|
_writeClass
|
_writeClass (
self,
parent,
class_name,
output,
)
Output the documentation for the class in the parent object.
Arguments
-
parent
- info about class parent (module, class)
-
class_name
- name of the class
-
output
- current output file object
|
|
_writeFunction
|
_writeFunction (
self,
function_name,
getInfo,
output,
)
Output the documentation for the function in the parent object.
Arguments
-
function_name
- the function name
-
getInfo
- reference to method, which will return function info
-
output
- current output file object
|
|
_writeModule
|
_writeModule ( self, module_name )
Output the documentation for the named module.
Arguments
-
module_name
- name of the module
|
|
_writeModules
|
_writeModules ( self )
Output documentation for all modules.
|
|
_writePackages
|
_writePackages ( self )
Output documentation for all packages.
|
|
closeOutput
|
closeOutput (
self,
output,
rtype=INDEX_FILE,
)
Closes output, where documentation has been written.
Arguments
-
output
- file object of opened documentation file
-
rtype
- gives info whether index, module or class file will be closed
|
|
openOutput
|
openOutput (
self,
name,
title,
subtitle,
rtype=INDEX_FILE,
)
Opens output, where documentation will be written.
Arguments
-
name
- output file name
-
title
- title of documentation file
-
subtitle
- subtitle of documentation file
-
rtype
- gives info whether index, module or class file will be opened
Returns file object of opened documentation file.
|
|
write
|
write ( self )
Write the documentation set to the output.
|
|