web2c: Option conventions

 
 3.1 Option conventions
 ======================
 
 To provide a clean and consistent behavior, we chose to have all these
 programs use the GNU function 'getopt_long_only' to parse command lines.
 However, we do use in a restricted mode, where all the options have to
 come before the rest of the arguments.
 
    As a result, you can:
    * use '-' or '--' to start an option name;
 
    * use any unambiguous abbreviation for an option name;
 
    * separate option names and values with either '=' or one or more
      spaces;
 
    * use filenames that would otherwise look like options by putting
      them after an option '--'.
 
    By convention, non-option arguments, if specified, generally define
 the name of an input file, as documented for each program.
 
    If a particular option with a value is given more than once, it is
 the last value that counts.
 
    For example, the following command line specifies the options 'foo',
 'bar', and 'verbose'; gives the value 'baz' to the 'abc' option, and the
 value 'xyz' to the 'quux' option; and specifies the filename '-myfile-'.
 
      -foo --bar -verb -abc=baz -quux karl --quux xyz -- -myfile-