Name
sid — Syntax Improving Device; parser generator
Synopsis
sid
[ -l lang | --language lang ] [ -s opt | --switch opt ] [ -t num | --tab-width num ]
input-file… [ input-file… ]
sid
Description
The sid command is used to turn descriptions of a language into a program for recognising that language. This manual page details the command line syntax; for more information, consult the sid user documentation.
The number of files specified on the command line varies depending upon the output language. The description of the --language option specifies the number of files for each language.
Switches
sid accepts both short form and long form command line switches. The long form equivalents are due to be removed in the next release.
Short form switches are single characters, and begin with a -
or +
character. They can be concatentated into a single command line word, e.g.:
-vdl dump-file lang
which contains three different switches (-v, which takes no arguments; -d, which takes one argument: dump-file; and -l, which takes one argument: lang).
Long form switches are strings, and begin with -- or ++. With long form switches, only the shortest unique prefix need be entered. The long form of the above example would be:
--version --dump-file dump-file --language lang
In most cases the arguments to the switch should follow the switch as a separate word. In the case of short form switches, the arguments to the short form switches in a single word should follow the word in the order of the switches (as in the first example). For some options, the argument may be part of the same word as the switch (such options are shown without a space between the switch and the argument in the switch summaries below). In the case of short form switches, such a switch would terminate any concatentation of switches (either a character would follow it, which would be treated as its argument, or it would be the end of the word, and its argument would follow as normal).
For binary switches, the - or -- switch prefixes set (enable) the switch, and the + or ++ switch prefixes reset (disable) the switch. This is probably back to front, but is in keeping with other programs. The switches -- or ++ by themselves terminate option parsing.
See Also
lexi, lex(1), flex(1), yacc(1), bison(1).