[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
7.23.8.2 Usage
- Function: module-stexi-documentation sym-name [%docs-resolver] [#:docs-resolver]
Return documentation for the module named sym-name. The documentation will be formatted as
stexi
(see section texinfo).
- Function: script-stexi-documentation scriptpath
Return documentation for given script. The documentation will be taken from the script’s commentary, and will be returned in the
stexi
format (see section texinfo).
- 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-generic-menu name entries
Create a menu from a generic alist of entries, the car of which should be the node name, and the cdr the description. As an exception, an entry of
#f
will produce a separator.
- 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-extended-menu name module-pairs script-pairs extra-entries
Create an "extended" menu, like the standard menu but with a section for scripts.
- 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 name filename prologue epilogue [#:module-stexi-documentation-args] [#:scripts]
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.
- Function: package-stexi-documentation-for-include modules module-descriptions [#:module-stexi-documentation-args]
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. Returns an stexinfo fragment.
Unlike
package-stexi-documentation
, this function simply produces a menu and the module documentations instead of producing a full texinfo document. This can be useful if you write part of your manual by hand, and just use@include
to pull in the automatically generated parts.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.
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
This document was generated on April 20, 2013 using texi2html 5.0.