SEARCH
NEW RPMS
DIRECTORIES
ABOUT
FAQ
VARIOUS
BLOG
DONATE


YUM REPOSITORY

 
 

MAN page from openSUSE Leap 42 fpc-2.6.4-1.1.i586.rpm

makeskel

Section: FPC unit description file generator (1)
Updated: 11 November 2004
Index 

NAME

makeskel - generate description file for fpdoc.

 

SYNOPSIS

makeskel [--descr=filename] [--disable-arguments] [--disable-errors] [--disable-function-results] [--disable-private] [--disable-protected] [--disable-seealso] [--emit-class-separator] [--help] [--lang=language] [--output=filename] [--update]--package=name --input=cmdline

 

Description

makeskelscans a Free Pascal unit source file and generates a skeleton descriptionfile for it. It generates nodes for all identifiers found in the interfacesection of the unit, although this behaviour can be adjusted with someoptions. It can also update an existing XML file, and then emits only nodesfor identifiers for which no node exists yet.

 

Usage

You can invoke makeskelwith as the only required arguments the inputandpackagearguments. 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. The output of makeskel will go to standard output by default.

 

Options

makeskelhas many options, most of them optional, defaults will be used in mostcases.

--descr=descfile
This option must be used in conjunction with the update option. It specifies the name of a description filedescfilewhich must be updated. Note that the file must contain valid XML, or theupdate will fail. This option can be specified more than once.
--disable-arguments
If this option is specified, makeskelwill not emit nodes for the arguments of functions and procedures. Bydefault, documentation nodes are emitted for functions and procedures aswell.
--disable-errors
By default, each documentation node will contain a errorsnode as well (excep for identifiers where this has no use, such as functionarguments). If this option is specified, no errorsnode will be generated.
--disable-function-results
By default, for functions, a resultnode will be generated, to describe the result of the function. If thisoption is specified, no function result node will be generated.
--disable-private
By default, documentation nodes are also generated for private fields or methods of a class. if this option is specified, the generation of nodes for privatefields or methods is skipped.
--disable-protected
By default, documentation nodes are also generated for protected fields ormethods of a class. if this option is specified, the generation of nodes for protected fields or methods is skipped.
--emit-class-separator
If this option is specified, a visible comment with the name of the classfor which documentation nodes will follow, is inserted between the nodesof two classes, making navigation easier.
--help
Emit a short help text and exit.
--input=cmd
The input (source) file to process. Multiple input files can be specified.The command may contain valid compiler options, currently the -Fipath(search path) and-dmacro(define macro) options are recognized.
--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.
--output=filename
This option tells makeskelwhere the output should go. If this option is not specified, the output issent to standard output (the screen).
--package=packagename
This option is required. It specifies the name of the package. All nodeswill be generated inside a node with name attributepackagename.
--update
Turns on update mode. In this mode, the output is a file which contains onlythe missing nodes to complete the documentation of the input files. Theexisting nodes must be specified with thedescrargument. Note that the output file may notbe the same as the input (description) nodes; A separate file must bespecified (or no file, in which case output goes to standard output.

 

SEE ALSO

ppc386(1)latex(1)fpdoc(1)


 

Index

NAME
SYNOPSIS
Description
Usage
Options
SEE ALSO

This document was created byman2html,using the manual pages.