1.7 KiB
curl man page generator
This is the curl man page generator. It generates a single nroff man page output from the set of sources files in this directory.
There is one source file for each supported command line option. The format is described below.
Option files
Each command line option is described in a file named <long name>.d, where
option name is written without any prefixing dashes. Like the file name for
the -v, --verbose option is named verbose.d.
Each file has a set of meta-data and a body of text.
Meta-data
Short: (single letter, without dash)
Long: (long form name, without dashes)
Arg: (the argument the option takes)
Magic: (description of "magic" options)
Tags: (space separated list)
Protocols: (space separated list for which protocols this option works)
Added: (version number in which this was added)
Mutexed: (space separated list of options this overrides, no dashes)
Requires: (space separated list of features this requires, no dashes)
See-also: (space separated list of related options, no dashes)
Help: (short text for the --help output for this option)
--- (end of meta-data)
Body
The body of the description. Only refer to options with their long form option version, like --verbose. The output generator will replace such with the correct markup that shows both short and long version.
Header
page-header is the nroff formatted file that will be output before the
generated options output for the master man page.
Generate
./gen.pl mainpage
This command outputs a single huge nroff file, meant to become curl.1. The
full curl man page.
./gen.pl listhelp
Generates a full curl --help output for all known command line options.