Formerly stdio/stdio.h.~43~
[kopensolaris-gnu/glibc.git] / manual / startup.texi
index 0bb3fec..2841363 100644 (file)
@@ -163,8 +163,8 @@ If the value of this variable is nonzero, then @code{getopt} prints an
 error message to the standard error stream if it encounters an unknown
 option character or an option with a missing required argument.  This is
 the default behavior.  If you set this variable to zero, @code{getopt}
-does not print any messages, but it still returns @code{?} to indicate
-an error.
+does not print any messages, but it still returns the character @code{?}
+to indicate an error.
 @end deftypevar
 
 @comment unistd.h
@@ -213,7 +213,7 @@ returned as if they were associated with option character @samp{\0}.
 The @code{getopt} function returns the option character for the next
 command line option.  When no more option arguments are available, it
 returns @code{-1}.  There may still be more non-option arguments; you
-must compare the external variable @code{optind} against the @var{argv}
+must compare the external variable @code{optind} against the @var{argc}
 parameter to check this.
 
 If the option has an argument, @code{getopt} returns the argument by
@@ -224,8 +224,11 @@ copy the @code{optarg} string, since it is a pointer into the original
 If @code{getopt} finds an option character in @var{argv} that was not
 included in @var{options}, or a missing option argument, it returns
 @samp{?} and sets the external variable @code{optopt} to the actual
-option character.  In addition, if the external variable @code{opterr}
-is nonzero (which is the default), @code{getopt} prints an error message.
+option character.  If the first character of @var{options} is a colon
+(@samp{:}), then @code{getopt} returns @samp{:} instead of @samp{?} to
+indicate a missing option argument.  In addition, if the external
+variable @code{opterr} is nonzero (which is the default), @code{getopt}
+prints an error message.
 @end deftypefun
 
 @node Example of Getopt
@@ -296,9 +299,9 @@ Non-option argument -
 @subsection Parsing Long Options
 
 To accept GNU-style long options as well as single-character options,
-use the function @code{getopt_long} instead of @code{getopt}.  You
-should do this in every program that uses options, for it takes little
-extra work and helps beginners remember how to use the program.
+use @code{getopt_long} instead of @code{getopt}.  You should make every
+program accept long options if it uses any options, for this takes
+little extra work and helps beginners remember how to use the program.
 
 @comment getopt.h
 @comment GNU