Next: , Previous: texinfo serialize, Up: Top


43 (texinfo reflection)

43.1 Overview

Routines to generare stexi documentation for objects and modules.

Note that in this context, an object is just a value associated with a location. It has nothing to do with GOOPS.

43.2 Usage

— Function: module-stexi-documentation [#:sym-name = #f] [#:docs-resolver = (lambda (name def) def)]

Return documentation for the module named sym-name. The documentation will be formatted as stexi (see texinfo).

— Function: object-stexi-documentation [#:object = #f] [#:name = "[unknown]"] [#:force = #f]

— Function: package-stexi-standard-copying name version updated years copyright-holder permissions

Create a standard texinfo copying section.

years is a list of years (as integers) in which the modules being documented were released. All other arguments are strings.

— Function: package-stexi-standard-titlepage name version updated authors

Create a standard GNU title page.

authors is a list of (name . email) pairs. All other arguments are strings.

Here is an example of the usage of this procedure:

           (package-stexi-standard-titlepage
            "Foolib"
            "3.2"
            "26 September 2006"
            '(("Alyssa P Hacker" . "alyssa@example.com"))
            '(2004 2005 2006)
            "Free Software Foundation, Inc."
            "Standard GPL permissions blurb goes here")

— Function: package-stexi-standard-menu name modules module-descriptions extra-entries

Create a standard top node and menu, suitable for processing by makeinfo.

— Function: package-stexi-standard-prologue name filename category description copying titlepage menu

Create a standard prologue, suitable for later serialization to texinfo and .info creation with makeinfo.

Returns a list of stexinfo forms suitable for passing to package-stexi-documentation as the prologue. See texinfo reflection package-stexi-documentation, package-stexi-standard-titlepage, package-stexi-standard-copying, and package-stexi-standard-menu.

— Function: package-stexi-documentation [#:modules = #f] [#:name = #f] [#:filename = #f] [#:prologue = #f] [#:epilogue = #f] [#:module-stexi-documentation-args = (quote ())]

Create stexi documentation for a package, where a package is a set of modules that is released together.

modules is expected to be a list of module names, where a module name is a list of symbols. The stexi that is returned will be titled name and a texinfo filename of filename.

prologue and epilogue are lists of stexi forms that will be spliced into the output document before and after the generated modules documentation, respectively. See texinfo reflection package-stexi-standard-prologue, to create a conventional GNU texinfo prologue.

module-stexi-documentation-args is an optional argument that, if given, will be added to the argument list when module-texi-documentation is called. For example, it might be useful to define a #:docs-resolver argument.