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.
SEE ALSO
ppc386(1) latex(1) makeskel(1)