## Ploticus config files

Welcome Gallery Handbook

Manual page for Ploticus_config_files(PL)

## DESCRIPTION

A configuration file may be used in order to initialize each invocation of ploticus in a certain way.`` Upon execution, ploticus checks for an environment variable called PLOTICUS_CONFIG, which should contain the full path name of your config file.`` A configuration file is not required (unless running in cgi mode ). If no config file is found, standard defaults will generally be used.``

The config file may be used to:

  set default modes of operation

  make month and weekday names appear in languages other than English

  make the standard absolute unit centimeters instead of inches

  set the default date format, and other date parameters

  set the default notation for numbers

## EXAMPLE

Examples of config files set up for Spanish and Russian are located in the gallery directory, named plconfig.spanish and plconfig.russian Note: Ploticus now has locale support so that non-latin alphabets may be used. See pl(1) environment

## 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 `//` or `#` are taken as comments; blank lines are skipped.``

## PARAMETERS

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

option: option [arg]

  Set any pl command line option (see pl(1) for a list of supported command line options). Command line options that are specific only to pltab are not supported.`` The given command line option will be in effect for all invocations of pl and pltab.`` This parameter may be used as many times as necessary.``
  Example:
  `option: -gif`
  `option: -viewer xv`

varvalue: varname=value

  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.``
  Example: `varvalue: MODE=normal`

putenv: varname=value

  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 cgi mode since a CGI process often inherits an environment that is not under the developer's control.``
  Example: `putenv: ERRMODE=normal`

tmpdir: dirname

  The directory that ploticus uses for temporary files.`` By default this is /usr/tmp. This can also be set in `pl.h`.``
  Example: `tmpdir: /tmp`

pathslash: slashchar

  The slash character used in path names. Default is for `/` unix. For windows/nt use `\`.`` This can also be set in `pl.h`.``

units: `in` | `cm`

  The measurement unit to be used for absolute units, either inches or centimeters.`` Default is `in`.``
  Example: `units: cm`

projectroot:

  The directory from which ploticus will operate. This must be specified when using pl in cgi mode.``

numbernotation: `standard` | `us` | `euro`

  Specifies how decimal point and thousands separators will be displayed. Default is `standard`.`` The following table illustrates:

       standard           us             euro
      ----------    ------------    -------------
           79              79               79
           79.5            79.5             79,5
         4321.79         4321.79          4321,79
        54321          54,321           54.321
       654321.07      654,321.07       654.321,07
      1987654321    1,987,654,321    1.987.654.321

## SYSTEM ENVIRONMENT

cpulimit:

  Number of seconds of CPU time that will be allowed to the pl or pltab process or any spawned subprocesses. Default is 10 seconds.`` Any process exceeding this will abort.``

filesizelimit:

  Number of bytes that will be allowed in any file that pl or pltab process or any spawned subprocesses creates. Default is 5000000 bytes.`` Any process exceeding this will abort.``

uid:

  Set the effective user id of the pl or pltab process and all its subprocesses.`` Only useful in CGI environments where programs are invoked as root,

gid:

  Same as uid, but sets the group id.``

## DATE-RELATED

dateformat: format

  Set the default date format.`` Supported date formats are described in dates
  Example: `dateformat: dd-mmm-yyyy`

pivotyear: yy

  Set the two digit year that should be used to convert two-digit years to four-digit years. If two-digit years are used, year values that are less than the pivot year are assumed to be 21st century years. Default is 77.``
  Example: `pivotyear: 50`

months: list

  Specify the three-character month abbreviations to be used, all in lower case, beginning with the first month.`` Default is the English (`jan feb mar apr may jun jul aug sep oct nov dec`).``
  Example (Spanish) (must all be on one line):
  `months: ene feb mar abr pue jun jul ago sep oct nov dic`

months.abbrev: list

  short month names, capitalized for presentation, begining with the first month.`` Default is English (`Jan Feb Mar Apr May June July Aug Sept Oct Nov Dec`).``
  Example (Spanish) (must all be on one line):
  `months.abbrev: Ene Feb Mar Abr Pue Jun Jul Ago Sep Oct Nov Dic`

months.full: list

  full month names, capitalized for presentation.``
  Example (Spanish) (must all be on one line):
  `months.full: Enero Febrero Marcha Abril Pueda Junio Julio Agosto Septiembre Octubre Noviembre Diciembre`

weekdays: list

  three-character weekday abbreviations, capitalized for presentation, beginning with Sunday.``
  Example (French): `weekdays: Dim Lun Mar Mer Jeu Ven Sam`
  Example (Spanish): `weekdays: Dom Lun Mar Mie Jue Vie Sab`
  data display engine
  Copyright Steve Grubb

Markup created by unroff 1.0, `` `` September 17, 2001.