Home       Trees       Index       Help   

epydoc 2.0

Package epydoc :: Package markup :: Module javadoc :: Class ParsedJavadocDocstring
[show private | hide private]
[frames | no frames]

Class ParsedJavadocDocstring

ParsedDocstring --+
                  |
                 ParsedJavadocDocstring

An encoded version of a Javadoc docstring. Since Javadoc is a fairly simple markup language, we don't do any processing in advance; instead, we wait to split fields or resolve crossreference links until we need to.
Method Summary
  __init__(self, docstring, errors)
Create a new ParsedJavadocDocstring.
string to_plaintext(self, docstring_linker, **options)
Translate this docstring to plaintext.
Inherited from ParsedDocstring: index_terms, summary, to_latex
    Field Splitting
(ParsedDocstring, list of Field) split_fields(self, errors)
Split this docstring into its body and its fields.
    HTML Output
string to_html(self, docstring_linker, **options)
Translate this docstring to HTML.

Method Details

__init__(self, docstring, errors=None)
(Constructor)

Create a new ParsedJavadocDocstring.
Parameters:
docstring - The docstring that should be used to construct this ParsedJavadocDocstring.
           (type=string)
errors - A list where any errors generated during parsing will be stored. If no list is given, then all errors are ignored.
           (type=list of ParseError)

split_fields(self, errors=None)

Split this docstring into its body and its fields.
Parameters:
errors - A list where any errors generated during splitting will be stored. If no list is specified, then errors will be ignored.
           (type=list of ParseError)
Returns:
A tuple (body, fields), where body is the main body of this docstring, and fields is a list of its fields.
           (type=(ParsedDocstring, list of Field))
Overrides:
epydoc.markup.ParsedDocstring.split_fields (inherited documentation)

to_html(self, docstring_linker, **options)

Translate this docstring to HTML.
Parameters:
docstring_linker - An HTML translator for crossreference links into and out of the docstring.
           (type=DocstringLinker)
options - Any extra options for the output. Unknown options are ignored.
Returns:
An HTML fragment that encodes this docstring.
           (type=string)
Overrides:
epydoc.markup.ParsedDocstring.to_html (inherited documentation)

to_plaintext(self, docstring_linker, **options)

Translate this docstring to plaintext.
Parameters:
docstring_linker - A plaintext translator for crossreference links into and out of the docstring.
           (type=DocstringLinker)
options - Any extra options for the output. Unknown options are ignored.
Returns:
A plaintext fragment that encodes this docstring.
           (type=string)
Overrides:
epydoc.markup.ParsedDocstring.to_plaintext (inherited documentation)

   Home       Trees       Index       Help   

epydoc 2.0

Generated by Epydoc 2.0 on Tue Jul 22 04:20:48 2003 http://epydoc.sf.net