doc – Automated documentation generation

This namespace module provides classes that can be used for generating documentation (in HTML, DocBook and XSL-FO).

class ll.xist.ns.doc.a(*content, **attrs)[source]

Bases: ll.xist.ns.doc.inline

A hypertext link.

class ll.xist.ns.doc.abbr(*content, **attrs)[source]

Bases: ll.xist.ns.doc.inline

Abbreviation.

class ll.xist.ns.doc.app(*content, **attrs)[source]

Bases: ll.xist.ns.doc.inline

The name of a software program.

class ll.xist.ns.doc.attr(*content, **attrs)[source]

Bases: ll.xist.ns.doc.code

The name of an attribute of a class/object.

class ll.xist.ns.doc.base(*content, **attrs)[source]

Bases: ll.xist.xsc.Element

The base of all element classes. Used for dispatching to conversion targets.

class ll.xist.ns.doc.block(*content, **attrs)[source]

Bases: ll.xist.ns.doc.base

Base class for all block level elements.

class ll.xist.ns.doc.class_(*content, **attrs)[source]

Bases: ll.xist.ns.doc.code

The name of a class, in the object-oriented programming sense.

class ll.xist.ns.doc.cls(*content, **attrs)[source]

Bases: ll.xist.ns.doc.inline

Use this class when referring to the object for which a class method has been called, e.g.:

this function fooifies the class <cls/>.
class ll.xist.ns.doc.const(*content, **attrs)[source]

Bases: ll.xist.ns.doc.code

The name of a constant.

class ll.xist.ns.doc.data(*content, **attrs)[source]

Bases: ll.xist.ns.doc.code

The name of a data object.

class ll.xist.ns.doc.dd(*content, **attrs)[source]

Bases: ll.xist.ns.doc.block

A wrapper for the elements of a list item dl.

class ll.xist.ns.doc.dir(*content, **attrs)[source]

Bases: ll.xist.ns.doc.code

The name of a directory.

class ll.xist.ns.doc.dl(*content, **attrs)[source]

Bases: ll.xist.ns.doc.list

A list in which each entry is marked with a label.

class ll.xist.ns.doc.dt(*content, **attrs)[source]

Bases: ll.xist.ns.doc.block

A term inside a dl.

class ll.xist.ns.doc.em(*content, **attrs)[source]

Bases: ll.xist.ns.doc.inline

Emphasized text.

class ll.xist.ns.doc.email(*content, **attrs)[source]

Bases: ll.xist.ns.doc.inline

An email address.

class ll.xist.ns.doc.example(*content, **attrs)[source]

Bases: ll.xist.ns.doc.block

A formal example.

class ll.xist.ns.doc.exc(*content, **attrs)[source]

Bases: ll.xist.ns.doc.code

The name of an exception class.

ll.xist.ns.doc.explain(thing, name=None, format=None, context=[])[source]

Return a XML representation of the doc string of thing, which can be a function, method, class or module.

If thing is not a module, you must pass the context in context, i.e. a list of names of objects into which thing is nested. This means the first entry will always be the module name, and the other entries will be class names.

class ll.xist.ns.doc.file(*content, **attrs)[source]

Bases: ll.xist.ns.doc.code

The name of a file.

class ll.xist.ns.doc.func(*content, **attrs)[source]

Bases: ll.xist.ns.doc.code

The name of a function or subroutine, as in a programming language.

class ll.xist.ns.doc.h(*content, **attrs)[source]

Bases: ll.xist.ns.doc.base

The text of the title of a section or an example.

class ll.xist.ns.doc.host(*content, **attrs)[source]

Bases: ll.xist.ns.doc.code

The name of a computer.

class ll.xist.ns.doc.inline(*content, **attrs)[source]

Bases: ll.xist.ns.doc.base

Base class for all inline elements.

class ll.xist.ns.doc.input(*content, **attrs)[source]

Bases: ll.xist.ns.doc.inline

Can be used inside a tty to mark the parts typed by the user.

class ll.xist.ns.doc.li(*content, **attrs)[source]

Bases: ll.xist.ns.doc.block

A wrapper for the elements of a list item in ul or ol.

class ll.xist.ns.doc.list(*content, **attrs)[source]

Bases: ll.xist.ns.doc.block

Common baseclass for ul, ol and dl.

class ll.xist.ns.doc.lit(*content, **attrs)[source]

Bases: ll.xist.ns.doc.code

Inline text that is some literal value.

class ll.xist.ns.doc.litblock(*content, **attrs)[source]

Bases: ll.xist.ns.doc.block

A literal text block (like source code or a shell session).

class ll.xist.ns.doc.markup(*content, **attrs)[source]

Bases: ll.xist.ns.doc.code

A string of formatting markup in text that is to be represented literally.

class ll.xist.ns.doc.meth(*content, **attrs)[source]

Bases: ll.xist.ns.doc.code

The name of a method or memberfunction in a programming language.

class ll.xist.ns.doc.mod(*content, **attrs)[source]

Bases: ll.xist.ns.doc.code

The name of a Python module.

class ll.xist.ns.doc.obj(*content, **attrs)[source]

Bases: ll.xist.ns.doc.code

A object of unspecified type.

class ll.xist.ns.doc.ol(*content, **attrs)[source]

Bases: ll.xist.ns.doc.list

A list in which each entry is marked with a sequentially incremented label.

class ll.xist.ns.doc.option(*content, **attrs)[source]

Bases: ll.xist.ns.doc.code

An option for a software command.

class ll.xist.ns.doc.p(*content, **attrs)[source]

Bases: ll.xist.ns.doc.block

A paragraph.

class ll.xist.ns.doc.prog(*content, **attrs)[source]

Bases: ll.xist.ns.doc.litblock

A literal listing of all or part of a program.

class ll.xist.ns.doc.prompt(*content, **attrs)[source]

Bases: ll.xist.ns.doc.inline

The prompt in a tty dump.

class ll.xist.ns.doc.prop(*content, **attrs)[source]

Bases: ll.xist.ns.doc.code

The name of a property in a programming language.

class ll.xist.ns.doc.pyref(*content, **attrs)[source]

Bases: ll.xist.ns.doc.inline

Reference to a Python object: module, class, method, property or function.

class ll.xist.ns.doc.rep(*content, **attrs)[source]

Bases: ll.xist.ns.doc.inline

Content that may or must be replaced by the user.

class ll.xist.ns.doc.section(*content, **attrs)[source]

Bases: ll.xist.ns.doc.block

A recursive section.

class ll.xist.ns.doc.self(*content, **attrs)[source]

Bases: ll.xist.ns.doc.code

Use this class when referring to the object for which a method has been called, e.g.:

this function fooifies the object <self/>;.
ll.xist.ns.doc.self_

alias of self

class ll.xist.ns.doc.strong(*content, **attrs)[source]

Bases: ll.xist.ns.doc.inline

Emphasized text.

class ll.xist.ns.doc.tab(*content, **attrs)[source]

Bases: ll.xist.xsc.Element

Used for displaying a tab character in the HTML output.

class ll.xist.ns.doc.tty(*content, **attrs)[source]

Bases: ll.xist.ns.doc.litblock

A dump of a shell session.

class ll.xist.ns.doc.ul(*content, **attrs)[source]

Bases: ll.xist.ns.doc.list

A list in which each entry is marked with a bullet or other dingbat.

class ll.xist.ns.doc.user(*content, **attrs)[source]

Bases: ll.xist.ns.doc.code

The name of a user account.

class ll.xist.ns.doc.xref(*content, **attrs)[source]

Bases: ll.xist.ns.doc.inline

An internal cross reference.

class ll.xist.ns.doc.z(*content, **attrs)[source]

Bases: ll.xist.ns.doc.inline

Put the content into double quotes.