[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

7.5.1.2 Program Configuration

Programs may be “pre-configured” before normal command line options are processed (See see section Immediate Action Attributes). How configuration files and environment variables are handled get specified with these attributes.

disable-load
disable-save

Indicates that the command line usage of --load-opts and/or --save-opts are disallowed.

environrc

Indicates looking in the environment for values of variables named, PROGRAM_OPTNAME or PROGRAM, where PROGRAM is the upper cased C-name of the program and OPTNAME is the upper cased C-name of a specific option. The contents of the PROGRAM variable, if found, are tokenized and processed. The contents of PROGRAM_OPTNAME environment variables are taken as the option argument to the option nameed optname.

homerc

Specifies either a directory or a file using a specific path, a path based on an environment variable or a path relative to installation directories. The method used depends on the first two characters of the name. If the first character is not the dollar character ($), then it is presumed to be a path name based on the current directory.

Otherwise, the method depends on the second character:

$

The path is relative to the directory where the executable was found.

@

The path is relative to the package data directory, e.g. /usr/local/share/autogen.

[a-zA-Z]

The path is derived from the named environment variable.

Use as many as you like. The presence of this attribute activates the --save-opts and --load-opts options. See the optionMakePath(3AGEN) man page for excruciating details. See section configuration file presets.

rcfile

Specifies the configuration file name. This is only useful if you have provided at least one homerc attribute. default: .<prog-name>rc


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

This document was generated by Bruce Korb on February 17, 2011 using texi2html 1.82.

Viewable With Any Browser   autogen Home