#set TITLE = "Ploticus config files"
#include top

.LP
A configuration file may be used to make certain settings
that will apply to all ploticus invocations.
A configuration file is not required (unless running in
#set FILE = cgi.html
#set TAG = "cgi mode"
#include link
).  If no config file is found, standard defaults will be used.
Upon execution, ploticus checks for an environment variable called
\fBPLOTICUS_CONFIG\fR, which should contain the full path name of
your config file.
.LP
If a config file is found, it will be read and processed before command line
arguments are evaluated, and before script interpretation begins.
.LP
Typical uses of a config file are to set up non-English 
month and weekday names,
to set default date or numeric notations, or to
use cm instead of inch as the absolute unit.
Many (but not all) of these settings can also be made from within an individual 
script using 
#set FILE = "settings.html"
#set TAG = "proc settings"
#include link

#include space

.SH EXAMPLE
Examples of config files set up for Spanish and Russian
are located in the gallery directory, named
#set FILE = "../gallery/plconfig.spanish"
#set TAG = "plconfig.spanish"
#include link
and
#set FILE = "../gallery/plconfig.russian"
#set TAG = "plconfig.russian"
#include link

#include space


.SH SYNTAX
One parameter is specified per line (see the example below).
Parameters are case-insensitive and must begin in the first column of the line.
Lines beginning with \fC//\fR or \fC#\fR are taken as 
comments; blank lines are skipped.

#include space

.SH PARAMETERS
.LP
The following parameters may be set.
Parameters that are not set assume the default value, which is shown
in (parentheses).

.LP
\fBprojectroot:\fR
.IP
The directory from which ploticus will operate.  This must be specified when
using pl in 
#set FILE = cgi.html
#set TAG = "cgi mode."
#include link

.LP
\fBoption:\fR \fIoption\fR [\fIarg\fR]
.IP
Set any pl command line option (see
.ig >>
<a href="pl.1.html">
.>>
pl(1)
.ig >>
</a>
.>>
 for a list of supported command line options)
or
#set FILE = "prefabs.html"
#set TAG = "prefab"
#include link
parameter.
The given command line option will be in effect for all invocations of pl.
This parameter may be used as many times as necessary.
.br
Example:
.nf
  option: -gif
  option: -viewer xv
  option: delim=comma
.fi

.LP
\fBvarvalue:\fR \fIvarname\fR=\fIvalue\fR
.IP
Preset a variable to a value.
This may be used as many times as desired within the config file to
set various variables.
This may also be used to set a variable that will be referenced later
in the config file.
.br
Example: \fCvarvalue: MODE=normal\fR

.LP
\fBputenv:\fR  \fIvarname\fR=\fIvalue\fR
.IP
Set an environment variable for current process and all subprocesses.
This may be used as many times as desired within the config file to
set various environment variables.  
Especially useful when operating in 
#set FILE = "cgi.html"
#set TAG = "cgi mode"
#include link
since a CGI process often inherits an environment that is not
under the developer's control.
.br
Example: \fCputenv: ERRMODE=normal\fR


.LP
\fBtmpdir:\fR \fIdirname\fR
.IP
The directory that ploticus uses for temporary files.
By default this is \fC/tmp\fR.
This can also be set in \fCpl.h\fR.
.br
Example: \fCtmpdir: /var/tmp\fR

// .LP
// \fBpathslash:\fR \fIslashchar\fR
// .IP
// The slash character used in path names.  Default is for \fC/\fR unix versions and
// \fC\\\fR for the win32 version.  [Probably no longer very useful.]
// This can also be set in \fCpl.h\fR.

#include settings.inc

#include bottom
