Aargh -- Automated Argument Helper

Aargh

The Header Element

The Header element may carry either or both of a name attribute and a directory attribute. Either of their values may include environmental variables, which aargh will expand as needed. For example:

<Header name="sample_opts.h" directory="$inc"/>

The name attribute

The value of the name attribute specifies the name of the generated header file. This is the name that aargh will #include in the implementation file.

If the specified file name contains a period, aargh will use the file name without change. Otherwise it will append a period and a file name extension. By default the extension is "h", but you can specify a different extension such as "hpp" on the aargh command line, using the -X option.

The specified file name may include a path, relative either to the current working directory or to the directory specified by the directory element described below. It may even include an absolute path, but that usage would be a bit strange.

If the Header element or the name attribute is not present, the header name defaults to "opts.h".

The directory attribute

If present, the value of the directory attribute specifies the directory where aargh will write the generated header file. It may provide an absolute path or a path relative to the current working directory.

When opening the header file, aargh will construct a file name by concatenating the value of the directory attribute with the header file name. It will also insert a forward slash between them, if the directory name does not already have one at the end.