diff options
author | Miles Bader <miles@gnu.org> | 1995-10-11 00:38:35 +0000 |
---|---|---|
committer | Miles Bader <miles@gnu.org> | 1995-10-11 00:38:35 +0000 |
commit | e0455278de43f40c946268c10fa3e30168216091 (patch) | |
tree | c4a7b57eadca6c2c45ea8f6371acfdfa15a321c9 /libshouldbeinlibc/argp.h | |
parent | 36e6e7a212f9202ba798631d7025f16e4f2e5db8 (diff) |
Doc fixes.
Diffstat (limited to 'libshouldbeinlibc/argp.h')
-rw-r--r-- | libshouldbeinlibc/argp.h | 22 |
1 files changed, 13 insertions, 9 deletions
diff --git a/libshouldbeinlibc/argp.h b/libshouldbeinlibc/argp.h index ee562885..239b39e1 100644 --- a/libshouldbeinlibc/argp.h +++ b/libshouldbeinlibc/argp.h @@ -28,21 +28,26 @@ #include <ctype.h> #include <getopt.h> +/* A description of a particular option. A pointer to an array of + these is passed in the OPTIONS field of an argp structure. Each option + entry can correspond to one long option and/or one short option; more + names for the same option can be added by following an entry in an option + array with options having the OPTION_ALIAS flag set. */ struct argp_option { /* The long option name. For more than one name for the same option, you can use following options with the OPTION_ALIAS flag set. */ char *name; - /* What key is returned for this option. If ascii and > 0, then it's also - accepted as a short option. */ + /* What key is returned for this option. If > 0 and printable, then it's + also accepted as a short option. */ int key; /* If non-NULL, this is the name of the argument associated with this - option, which is required unless the OPTION_ARG_OPTIONAL flags is set. */ + option, which is required unless the OPTION_ARG_OPTIONAL flag is set. */ char *arg; - /* ARGP_OPTION_ flags. */ + /* OPTION_ flags. */ int flags; /* The doc string for this option. */ @@ -82,11 +87,10 @@ typedef error_t (*argp_parser_t)(int key, char *arg, struct argp_state *state); /* There are no more command line arguments at all. */ #define ARGP_KEY_END 1 /* Because it's common to want to do some special processing if there aren't - any non-option args, user parsers are called with this key if there they - didn't get a chance to process any non-option arguments; note that having - been given a non-option arg and returned EINVAL counts. Called just - before ARGP_KEY_END (where more general validity checks on previously - parsed arguments can take place). */ + any non-option args, user parsers are called with this key if they didn't + successfully process any non-option arguments. Called just before + ARGP_KEY_END (where more general validity checks on previously parsed + arguments can take place). */ #define ARGP_KEY_NO_ARGS 2 /* An argp structure contains a set of getopt options declarations, a |