GNU AutoGen - The Automated Program Generator: 7.5.1.2 Program Configuration

[ < ] | [ > ] |  | [ << ] | [ 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 March 7, 2011 using texi2html 1.82.