Package: atdoc

Function generate-html-documentation

Lambda List

generate-html-documentation (packages directory &key (index-title No Title) (heading No Heading) (css default.css) (logo nil) (single-page-p nil) (include-slot-definitions-p nil) (include-internal-symbols-p t))

Arguments

  • packages -- List of package designators. Documentation will be generated for these packages.
  • directory -- A pathname specifying a directory. All output files and temporary data will be written to this directory, which must already exist.
  • index-title -- This string will be used as the title of the main page, index.html. (Other pages will be named according to the object they are documenting.)
  • heading -- This string will be used as a visible title on top of every page.
  • logo -- Deprecated.
  • css -- A pathname or string pointing to a cascading stylesheet (CSS) file. This file will be copied to the target directory under the name index.css. If this argument is a string and does not start with a dot, it will be taken as namestring relative to the atdoc/css directory.
  • single-page-p -- A boolean.
  • include-slot-definitions-p -- A boolean.
  • include-internal-symbols-p -- A boolean.

Return Value

The pathname of the generated file index.xml.

Details

Generates HTML documentation for packages.

With single-page-p, all documentation is assembled as a single page called index.html. Otherwise, index.html will include only a symbol index and a summary of each package, with links to other pages.

With include-slot-definitions-p, pages for symbols that are not exported will be included, so that documentation for exported symbols can safely refer to internal pages (but internal symbols will not be included in the symbol index automatically). This option has no effect if single-page-p is enabled.

With include-slot-definition, class documentation will include a list of direct slots.