4  * @brief Hunt for options in the option descriptor list
66  * @param pOpts      option data
67  * @param opt_name   name of option to look for
81             continue; /* doc option */  in opt_ambiguities()
96  * @param pOpts      option data
97  * @param opt_name   name of option to look for
99  * @param index      pointer to int for option index
100  * @param disable    pointer to bool to mark disabled option
114          *  If option disabled or a doc option, skip to next  in opt_match_ct()
136          *     *AND* the option name matches the disable name  in opt_match_ct()
155             continue; /* does not match any option */  in opt_match_ct()
170  *  Set the option to the indicated option number.
172  * @param opts      option data
173  * @param arg       option argument (if glued to name)
174  * @param idx       option index
175  * @param disable   mark disabled option
176  * @param st        state about current option
211  *  An option was not found.  Check for default option and set it
214  * @param opts   option data
215  * @param name   name of option to look for
216  * @param arg    option argument
217  * @param st     state about current option
227      *     *AND* there is a default named option,  in opt_unknown()
228      *  THEN return that option.  in opt_unknown()
253  * @param opts      option data
254  * @param name      name of option to look for
276  * what:  Process a vendor option
283  *  never specify this directly.  It gets referenced when the option
316          *  See if the enclosed option is okay with that state.  in optionVendorOption()
324          *  See if the enclosed option is okay with that state.  in optionVendorOption()
332  *  Find the option descriptor by full name.
334  * @param opts      option data
335  * @param opt_name  name of option to look for
336  * @param state     state about current option
375  *  Find the short option descriptor for the current option
377  * @param pOpts      option data
378  * @param optValue   option flag character
379  * @param pOptState  state about current option
388      *  Search the option list  in opt_find_short()
419      *    AND there is a special number option ("-n")  in opt_find_short()
420      *  THEN the result is the "option" itself and the  in opt_find_short()
421      *       option is the specially marked "number" option.  in opt_find_short()
449  *  Process option with a required argument.  Long options can either have a
453  *  @param[in,out] opts  the program option descriptor
454  *  @param[in,out] o_st  the option processing state
481         fputs("AutoOpts lib error: option type not selected\n", stderr);  in get_opt_arg_must()
487          *  The option was selected by default.  The current token is  in get_opt_arg_must()
488          *  the option argument.  in get_opt_arg_must()
506  * Process an option with an optional argument.  For short options, it looks
507  * at the character after the option character, or it consumes the next full
509  * the long option name before deciding to take the next command line
512  * @param pOpts      the option descriptor
520      *  An option argument is optional.  in get_opt_arg_may()
572      *  After an option with an optional argument, we will  in get_opt_arg_may()
573      *  *always* start with the next option because if there  in get_opt_arg_may()
574      *  were any characters following the option name/flag,  in get_opt_arg_may()
582  *  Process option that does not have an argument.
584  *  @param[in,out] opts  the program option descriptor
585  *  @param[in,out] o_st  the option processing state
592      *  No option argument.  Make sure next time around we find  in get_opt_arg_none()
593      *  the correct option flag character for short options  in get_opt_arg_none()
599      *  It is a long option.  Make sure there was no ``=xxx'' argument  in get_opt_arg_none()
607      *  It is a long option.  Advance to next command line argument.  in get_opt_arg_none()
616  *  Process option.  Figure out whether or not to look for an option argument.
618  *  @param[in,out] opts  the program option descriptor
619  *  @param[in,out] o_st  the option processing state
657  *  Find the option descriptor for the current option.
659  *  @param[in,out] opts  the program option descriptor
660  *  @param[in,out] o_st  the option processing state
667      *  IF we are continuing a short option list (e.g. -xyz...)  in find_opt()
668      *  THEN continue a single flag option.  in find_opt()
708      *  Note the kind of flag/option marker  in find_opt()
720      *  The current argument is to be processed as an option argument  in find_opt()
725      *  We have an option marker.  in find_opt()
726      *  Test the next character for long option indication  in find_opt()
749      *  option processing.  Otherwise the character must be a  in find_opt()
750      *  short (i.e. single character) option.  in find_opt()