fpdoc (1) - Linux Manuals

fpdoc: The FPC Pascal unit documentation generator.

NAME

fpdoc - The FPC Pascal unit documentation generator.

SYNOPSIS

fpdoc --input=inputcommand [--output=output] [--format=fmt] [--descr=descriptionfile] [--show-private] [--hide-protected] [--lang=language] [--content=contentfile] [--import=importfile] [--package=packagename] [--html-search=searchpage] [--ostarget=target] [--cpu-target=target] [--latex-extension=ext] [--latex-highlight]

Description

fpdoc scans a Free Pascal unit source file and generates documentation for it. The documentation can be in various formats (currently HTML and LaTeX) It can read various description files which contain the description for the various symbols found in the unit file.

Usage

You can invoke fpdoc with as the only required argument the 'input' and 'package' arguments. It should at least contain the name of the unit file for which documentation should be generated and the name of the package to which the unit belongs.

Options

fpdoc has several options, most of them optional, defaults will be used in most cases.

--content

This option tells fpdoc to generate a content file. A content file contains a list of all the possible anchors (labels) in the generated documentation file, and can be used to create cross-links in documentation for different units, using the --import option.

--descr=descfile

This option specifies the name of a description file descfile that contains the actual documentation for the unit. This option can be given several times, for several description files.

--format=fmt

Specifies the format fmt in which the documentation will be generated. Currenly, the following formats are known:

htm

HTML with 8.3 conforming filenames.

html

HTML with long filenames.

xhtml

XHTML with long filesnames.

latex

LaTex, which uses the fpc.sty style used by the Free Pascal documentation.

xml-struct

Structured XML.

--hide-protected

By default, the documentation will include descriptions and listings of protected fields and methods in classes or objects. This option changes this behaviour; if it is specified, no documentation will be generated for these methods. Note that public methods or properties that refer to these protected method will then have a dangling (i.e. unavailable) link.

--html-search=link

Adds an entry for an HTML search page at location link in the headers of the generated HTML pages. There is no search page provided, this should be made and provided by the user.

--import=impfile

imports a content file impfile from another documentation set. This can be used to resolve references to elements within this other documentation file;

--input=cmd

This option tells fpdoc what input file should be used. The argument cmd can be just a filename, but can also be a complete compiler command-line with options that concern the scanning of the pascal source: defines, include files, syntax options, as they would be specified to the free pascal compiler when compiling the file. If a complete command is used, then it should be enclosed in single or double quotes, so the shell will not break them in parts. It is possible to specify multiple input commands; they will be treated one by one, and documentation will be generated for each of them.

--lang=language

Sets the language for the output file. This will mainly set the strings used for the headers in various parts of the documentation files (by default they're in english). Currently, valid options are

de

German.

fr

French.

nl

Dutch.

--latex-extension=ext

Sets the extension to use for the LaTeX file to ext the default is .tex (with . (dot) included).

--latex-highlight

Switches on an internal latex syntax highlighter. This is not yet implemented. By default, syntax highlighting is provided by the syntax package that comes with fpc.

--output=name

This option tells fpdoc where the output file should be generated. How this option is interpreted depends on the format that is used. For latex, name is interpreted as the filename for the tex file. For all other formats, name is interpreted as the directory where all documentation files will be written. The directory will be created if it does not yet exist. Standard this equals the package name.

--package=packagename

Specifies the package name. All units will be documented as part of packagename , which is also the default output filename or directory. Only documentation nodes inside a package node with this name will be considered when documenting.

--show-private

By default, no documentation is generated for private methods or fields. This option causes fpdoc to generate documentation for these methods as well.

--warn-no-node

If this option is specified, fpdoc will emit a warning if it does not find a description node for an identifier it is documenting.