[5.1 Assembly]module

module — .

Description

Within a structure, the module elements describe the subunits of the structure. If the structure represents a book, then the modules are effectively the chapters, appendixes, etc. If the structure represents an interactive help system or web site, then the modules may be pages or sets of pages within that system.

In the simplest case, a module points to the resource that is the body of the module. In more complex cases, a module may impose more structure through nested modules.

If contentonly is true, then only the content of the referenced resource is included (that is, the children of the root element, but not the root element itself).

If omittitles is true, then the title elements of the referenced resource are not included.

Note

The omittitles attribute seems redundant, or perhaps just misnamed (notitles?) given the existence of override.

Processing expectations

Never rendered directly. The content that results from processing a module is generally rendered in the normal fashion.

Examples

FIXME: TBD.