Libc-498.tar.gz

[apple/libc.git] / stdlib / FreeBSD / getsubopt.3.patch

diff --git a/stdlib/FreeBSD/getsubopt.3.patch b/stdlib/FreeBSD/getsubopt.3.patch
new file mode 100644 (file)
index 0000000..5b472e7
--- /dev/null
+++ b/stdlib/FreeBSD/getsubopt.3.patch
@@ -0,0 +1,69 @@
+--- _SB/Libc/stdlib/FreeBSD/getsubopt.3        2004-11-25 11:38:41.000000000 -0800
++++ _SB/Libc/stdlib/FreeBSD/getsubopt.3.edit   2006-06-28 16:55:52.000000000 -0700
+@@ -44,23 +44,27 @@
+ .In stdlib.h
+ .Vt extern char *suboptarg ;
+ .Ft int
+-.Fn getsubopt "char **optionp" "char * const *tokens" "char **valuep"
++.Fo getsubopt
++.Fa "char **optionp"
++.Fa "char *const *keylistp"
++.Fa "char **valuep"
++.Fc
+ .Sh DESCRIPTION
+ The
+ .Fn getsubopt
+ function
+-parses a string containing tokens delimited by one or more tab, space or
+-comma
++parses a string containing tokens that are delimited
++by one or more tab, space, or comma
+ .Pq Ql \&,
+ characters.
+-It is intended for use in parsing groups of option arguments provided
+-as part of a utility command line.
++It is intended for use in parsing groups of option arguments
++that are provided as part of a utility command line.
+ .Pp
+ The argument
+ .Fa optionp
+ is a pointer to a pointer to the string.
+ The argument
+-.Fa tokens
++.Fa keylistp
+ is a pointer to a
+ .Dv NULL Ns -terminated
+ array of pointers to strings.
+@@ -69,10 +73,10 @@
+ .Fn getsubopt
+ function
+ returns the zero-based offset of the pointer in the
+-.Fa tokens
+-array referencing a string which matches the first token
+-in the string, or, \-1 if the string contains no tokens or
+-.Fa tokens
++.Fa keylistp
++array, referencing a string which matches the first token in the string
++ or \-1 if the string contains no tokens or
++.Fa keylistp
+ does not contain a matching string.
+ .Pp
+ If the token is of the form ``name=value'', the location referenced by
+@@ -97,7 +101,7 @@
+ if no ``value'' portion was present.
+ .Sh EXAMPLES
+ .Bd -literal -compact
+-char *tokens[] = {
++char *keylistp[] = {
+       #define ONE     0
+               "one",
+       #define TWO     1
+@@ -118,7 +122,7 @@
+       case 'b':
+               options = optarg;
+               while (*options) {
+-                      switch(getsubopt(&options, tokens, &value)) {
++                      switch(getsubopt(&options, keylistp, &value)) {
+                       case ONE:
+                               /* process ``one'' sub option */
+                               break;