MAN page from RedHat EL 8 fpc-3.2.0-1.el8.x86_64.rpm

fpdoc

Section: Free Pascal unit documentation generator (1)
Updated: 9 march 2002
Index

NAME

fpdoc - The FPC Pascal unit documentation generator.

SYNOPSIS

fpdoc --input=inputcommand [--output=output] [--format=fmt] [--descr=descriptionfile] [--package=packagename] [options]

Description

fpdocscans 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 fpdocwith 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 theunit belongs.

Options

fpdochas several options, most of them optional, defaults will be used in mostcases.

--content

This option tells fpdocto generate a content file. A content file contains a list of all thepossible anchors (labels) in the generated documentation file, and can beused to create cross-links in documentation for different units, using the--importoption.

--cputarget=value

This option tells fpdocfor which CPU to generate documentation. This simply defines the appropriate CPU macros.

--descr=descfile

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

--descr-dir=dir

This option specifies the name of a directory with XML description files, nameddirThis option can be given several times, for several description directories. This option is equivalent to specifying all files in the directory with the --descr option.

--dont-trim

This option tells fpdoc not to trim whitespace in the XML files.By default, whitespace is trimmed from the input, which can have undesirable side-effectsin for instance PRE tags.

--dry-run

This option tells fpdoc not to generate any output, but just parse all input. This can be used with the verbose optionto check what errors remain in the documentation, or what is still missing.

--format=fmt

Specifies the formatfmtin which the documentation will be generated. Currenly,the following formats are known:

chm: CHM with 8.3 conforming filenames, for windows mostly.
dxml: Delphi compatible XML output.
htm: HTML with 8.3 conforming filenames.
html: HTML with long filenames.
ipf: IPF output (OS/2 format, can be used with docview from fpGUI).
xhtml: XHTML with long filesnames.
latex: LaTex, which uses the fpc.sty style used by the Free Pascal documentation.
man: man page output (unix manual pages, one page per identifier).
rtf: RTF output.
txt: Plain text output.
xml-struct: Structured XML.

--help

Show a command-line option summary.

--hide-protected

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

--html-search=link

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

--import=impfile

imports a content file impfilefrom another documentation set. This can be used toresolve references to elements within this other documentation file;

--input=cmd

This option tells fpdocwhat input file should be used. The argumentcmdcan be just a filename, but canalso 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 oneby one, and documentation will be generated for each of them.

--input-dir=dir

This option tells fpdocto add all .pas and .pp files in the directory namedcmdas input files to the documenter. This is equivalend to specifying all files in the directory with the --input command.

--lang=language

Sets the language for the output file. This will mainly set the strings usedfor the headers in various parts of the documentation files (by defaultthey'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 toextthe default is .tex(with . (dot) included).

--latex-highlight

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

--mo-dir=dir

This option tells fpdocwhere to look for the translation files that can be used to internationalize fpdoc's output.

--ostarget=value

This option tells fpdocfor which operating system to generate documentation. This simply defines the appropriate operating system macros.

--output=name

This option tells fpdocwhere the output file should be generated. How this option is interpreteddepends on the format that is used. For latex, nameis interpreted as thefilename for the tex file. For all other formats,nameis interpreted asthe directory where all documentation files will be written. The directorywill be created if it does not yet exist. Standard this equals the packagename.

--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 documentationnodes inside a package node with this name will be considered whendocumenting.

--parse-impl

(Experimental) try to parse the implementation of a unit too, this can be used for syntax checking.

--project=file

This option tells fpdocto read all options from a project file. This is an XML file, please see the documentation for more information about the format for this file.

--show-private

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

--verbose

By default, fpdocis sparse with output. This tells fpdoc to generate some more information about what it is doing.

--warn-no-node

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

--write-project=file

If this option is specified, fpdocwill write a fpdoc project file (to the specified file name) that corresponds to the command-line options given.

This document was created byman2html,using the manual pages.