This code will accept any of the following as equivalent:

cmd -aoarg file file

cmd -a -o arg file file

cmd -oarg -a file file

cmd -a -oarg -- file file

SEE ALSO

sh(1), getopt(3)

DIAGNOSTICS

getopt prints an error message on the standard error output when it encounters an option letter not included in optstring.

HISTORY

Written by Henry Spencer, working from a Bell Labs manual page. Behavior believed identical to the Bell version.

BUGS

Whatever getopt(3) has.

Arguments containing whitespace or embedded shell meta characters generally will not survive intact; this looks easy to fix but isn't.

The error message for an invalid option is identified as coming from getopt rather than from the shell procedure containing the invocation of getopt; this, again, is hard to fix.

The precise best way to use the set command to set the arguments without disrupting the value(s) of shell options varies from one shell version to another.

21 June 1993

giftopnm

giftopnm—Convert a GIF file into a portable anymap

SINOPSIS

giftopnm [-verbose][-comments][-image N][GIFfile]

DESCRIPTION

Reads a GIF file for input, and outputs portable anymap.

OPTIONS

All flags can be abbreviated to their shortest unique prefix.

BUGS

This does not correctly handle the Plain Text Extension of the GIF89 standard, since I did not have any example input files containing them.

SEE ALSO

ppmtogif(1), ppm(5)

AUTHOR

Copyright " 1993 by David Koblas (koblas@netcom.com)

29 September 1993

gindxbib

gindxbib—Make inverted index for bibliographic databases

SINOPSIS

gindxbib [_vw] [_c file] [_d dir] [_f file] [_h n] [_i string]

[_k n] [_l n] [_n n] [_o file] [_t n] [filename ...]

DESCRIPTION

gindxbib makes an inverted index for the bibliographic databases in filename... for use with grefer(1), glookbib(1), and lkbib(1). The index will be named filename.i; the index is written to a temporary file which is then renamed to this. If no filenames are given on the command line because the _f option has been used, and no _o option is given, the index will be named Ind.i.

Bibliographic databases are divided into records by blank lines. Within a record, each fields starts with a % character at the beginning of a line. Fields have a one-letter name that follows the % character.

The values set by the _c, _n, _l, and _t options are stored in the index; when the index is searched, keys will be discarded and truncated in a manner appropriate to these options; the original keys will be used for verifying that any record found using the index actually contains the keys. This means that a user of an index need not know whether these options were used in the creation of the index, provided that not all the keys to be searched for would have been discarded during indexing and that the user supplies at least the part of each key that would have remained after being truncated during indexing. The value set by the _i option is also stored in the index and will be used in verifying records found using the index.

OPTIONS