summaryrefslogtreecommitdiff
path: root/manual/getopt.texi
diff options
context:
space:
mode:
authorUlrich Drepper <drepper@redhat.com>1999-12-29 17:52:49 +0000
committerUlrich Drepper <drepper@redhat.com>1999-12-29 17:52:49 +0000
commitdbbbaf53352501384c57512e2251c9d7169388af (patch)
treeee82c0b6703dcaa060e93c02e3bf108c2176e78f /manual/getopt.texi
parent15a2315cb457be0599d7a662e64aa54e560f96f0 (diff)
Update.
1999-12-29 Andreas Jaeger <aj@suse.de> * sysdeps/unix/sysv/linux/alpha/sys/io.h: Don't include <asm/io.h>; remove K&R compatibility; add missing ints. * sysdeps/unix/sysv/linux/arm/sys/io.h: Remove K&R compatibility, add missing ints. * sysdeps/unix/sysv/linux/sys/io.h: Don't include <asm/io.h>. 1999-12-29 Andreas Jaeger <aj@suse.de> * manual/getopt.texi (Using Getopt): Document ordering of options. 1999-12-29 Andreas Jaeger <aj@suse.de> * sysdeps/unix/sysv/linux/llseek.c: Emit link time warning for llseek. Requested by Michael Deutschmann <michael@talamasca.wkpowerlink.com>. 1999-12-14 Andreas Jaeger <aj@suse.de> * sysdeps/unix/sysv/linux/scsi/scsi.h: Add new defines from Linux 2.3.32. 1999-12-28 Jakub Jelinek <jakub@redhat.com> * elf/sprof.c (load_shobj): Fix error message. (generate_call_graph): Cast %*s length argument to int. * locale/programs/localedef.c (construct_output_path): Likewise. * locale/programs/ld-ctype.c (ctype_finish): Use proper format specifier. (ctype_class_new): Likewise. * locale/programs/ld-time.c (time_finish): Likewise. * sunrpc/svc_simple.c (register_rpc): Likewise. * nscd/connections.c (nscd_run, start_threads): Use long instead of int to avoid cast warnings. * sysdeps/ieee754/ldbl-128/e_atan2l.c (__ieee754_atan2l): Kill warning. * sysdeps/ieee754/ldbl-128/s_roundl.c (__roundl): Remove unused variable se. * time/strftime.c (my_strftime): Provide wide era string when requested. * sysdeps/sparc/fpu/bits/mathinline.h (__signbit, __signbitl): Separate into 32bit and 64bit versions.
Diffstat (limited to 'manual/getopt.texi')
-rw-r--r--manual/getopt.texi19
1 files changed, 19 insertions, 0 deletions
diff --git a/manual/getopt.texi b/manual/getopt.texi
index f3934d0cfe..aefb034566 100644
--- a/manual/getopt.texi
+++ b/manual/getopt.texi
@@ -71,10 +71,29 @@ string can be followed by a colon (@samp{:}) to indicate that it takes a
required argument. If an option character is followed by two colons
(@samp{::}), its argument is optional; this is a GNU extension.
+@code{getopt} has three ways to deal with options that follow
+non-options @var{argv} elements. The special argument @samp{--} forces
+in all cases the end of option scanning.
+
+@itemize @bullet
+@item
+The default is to permute the contents of @var{argv} while scanning it
+so that eventually all the non-options are at the end. This allows
+options to be given in any order, even with programs that were not
+written to expect this.
+
+@item
If the @var{options} argument string begins with a hyphen (@samp{-}), this
is treated specially. It permits arguments that are not options to be
returned as if they were associated with option character @samp{\0}.
+@item
+POSIX demands the following behaviour: The first non-option stops option
+processing. This mode is selected by either setting the environment
+variable @code{POSIXLY_CORRECT} or beginning the @var{options} argument
+string with a plus sign (@samp{+}).
+@end itemize
+
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