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 = '[email protected]'; 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.

`rcsection'

If you have a collection of option descriptions that are intended to use the same RC/ini files, then you will likely want to partition that file. That will be possible by specifying this attribute with AutoOpts version 9.2 and later.

Every RC file will be considered partitioned by lines that commence with the square open bracket ([). All text before such a line is always processed. Once such a line is found, the upper-cased c-variable-syntax program name will be compared against the text following that bracket. If there is a match and the next character after that is a square close bracket (]), then the section is processed and the file closed. Otherwise, the section is ignored and a matching section is searched for.

For exampe, if the fumble-stumble options had a sectioned RC file, then a line containing [FUMBLE_STUMBLE] would be searched for.

`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.