Man Linux: Main Page and Category List

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)