7.3.3 Program Information Attributes

These attributes are used to define how and what information is displayed to the user of the program.

`copyright'

The copyright is a structured value containing three to five values. If copyright is used, then the first three are required.

1. `date' - the list of applicable dates for the copyright.
2. `owner' - the name of the copyright holder.
3. `type' - specifies the type of distribution license. AutoOpts/AutoGen will automatically support the text of the GNU Public License (`GPL'), the GNU General Public License with Library extensions (`LGPL'), the Free BSD license (`BSD'), and a write-it-yourself copyright notice (`NOTE'). Only these values are recognized.
4. `text' - the text of the copyright notice. It is only needed if `type' is set to `NOTE'.
5. `author' - in case the author name is to appear in the documentation and is different from the copyright owner.
6. `eaddr' - email address of the author or copyright holder.

An example of this might be:

copyright = { date = "1992-2003"; owner = "Bruce Korb"; eaddr = 'bkorb@gnu.org'; type = GPL; };

`detail'

This string is added to the usage output when the HELP option is selected.

`explain'

Gives additional information whenever the usage routine is invoked..

`preserve-case'

This attribute will not change anything except appearance. Normally, the option names are all documented in lower case. However, if you specify this attribute, then they will display in the case used in their specification. Command line options will still be matched without case sensitivity.

`prog-desc and'

`opts-ptr'

These define global pointer variables that point to the program descriptor and the first option descriptor for a library option. This is intended for use by certain libraries that need command line and/or initialization file option processing. These definitions have no effect on the option template output, but are used for creating a library interface file. Normally, the first "option" for a library will be a documentation option that cannot be specified on the command line, but is marked as settable. The library client program will invoke the SET_OPTION macro which will invoke a handler function that will finally set these global variables.

`usage'

Optionally names the usage procedure, if the library routine optionUsage() does not work for you. If you specify gnu_usage as the value of this attribute, for example, you will use a procedure by that name for displaying usage. Of course, you will need to provide that procedure.

`gnu-usage'

Normally, the default format produced by the optionUsage procedure is AutoOpts Standard. By specifying this attribute, the default format will be GNU-ish style. Either default may be overridden by the user with the AUTOOPTS_USAGE environment variable. If it is set to gnu or autoopts, it will alter the style appropriately. This attribute will conflict with the usage attribute.