NaturalDocs:: Settings

A package to handle the command line and various other program settings.

Usage and Dependencies

The Constant Functions can be called immediately.
Prior to initialization, NaturalDocs::Builder must have all its output packages registered.
To initialize, call ParseCommandLine(). All other functions will then be available.

Summary

NaturalDocs:: Settings	A package to handle the command line and various other program settings.
Variables
inputDirectory	The input directory.
projectDirectory	The project directory.
outputFormats	A hash of the output formats and directories being used.
rebuildAll	Whether the script should rebuild all output and data files from scratch.
isQuiet	Whether the script should be run in quiet mode or not.
defaultOutputStyle	The style to be used if an output format doesn’t have its own style specified.
outputStyles	A hash of the output format styles.
Functions
ParseCommandLine	Parses and validates the command line.
PrintSyntax	Prints the syntax reference.
InputDirectory	Returns the input directory.
OutputDirectory	Returns the output directory of an output format.
OutputFormats	Returns a hashref of the output formats and their directories.
OutputStyle	Returns the style associated with an output format.
ProjectDirectory	Returns the project directory.
StyleDirectory	Returns the main style directory.
RebuildAll	Returns whether the script should rebuild all output and data files from scratch.
IsQuiet	Returns whether the script should be run in quiet mode or not.
Constant Functions
AppVersion	Returns a string of the current version number of Natural Docs.
AppURL	Returns a string of the project’s current web address.
FileVersion	Returns a string of the current file version number of Natural Docs.

Variables

inputDirectory

my $inputDirectory

The input directory.

projectDirectory

my $projectDirectory

The project directory.

outputFormats

my %outputFormats

A hash of the output formats and directories being used. The keys are the package names, and the values are their corresponding directories.

rebuildAll

my $rebuildAll

Whether the script should rebuild all output and data files from scratch.

isQuiet

my $isQuiet

Whether the script should be run in quiet mode or not.

defaultOutputStyle

my $defaultOutputStyle

The style to be used if an output format doesn’t have its own style specified.

outputStyles

my %outputStyles

A hash of the output format styles. The keys are the package names, and the values are the style strings. If a package does not have an entry in this hash, it uses defaultOutputStyle.

Functions

ParseCommandLine

sub ParseCommandLine

Parses and validates the command line. Will cause the script to exit if the options ask for the syntax reference or are invalid. Needs to be run before calling any other functions in this package.

PrintSyntax

sub PrintSyntax

Prints the syntax reference.

InputDirectory

sub InputDirectory

Returns the input directory.

OutputDirectory

sub OutputDirectory #(package)

Returns the output directory of an output format.

Parameters

package

The output package.

Returns

The output format directory, or undef if the format wasn’t specified.

OutputFormats

sub OutputFormats

Returns a hashref of the output formats and their directories. The keys are the package names, and the values are their directories. The hashref is not a copy of the data, so don’t change it.

OutputStyle

sub OutputStyle #(package)

Returns the style associated with an output format.

Parameters

package

The output package.

Returns

The style string.

ProjectDirectory

sub ProjectDirectory

Returns the project directory.

StyleDirectory

sub StyleDirectory

Returns the main style directory.

RebuildAll

sub RebuildAll

Returns whether the script should rebuild all output and data files from scratch.

IsQuiet

sub IsQuiet

Returns whether the script should be run in quiet mode or not.

Constant Functions

AppVersion

sub AppVersion

Returns a string of the current version number of Natural Docs.

AppURL

sub AppURL

Returns a string of the project’s current web address.

FileVersion

sub FileVersion

Returns a string of the current file version number of Natural Docs. This may be different from AppVersion. If ever a data file is loaded that doesn’t match this version, the file should be regenerated. This prevents upgrades/downgrades to versions that have different file formats from causing errors.