1 files changed, 51 insertions, 25 deletions
diff --git a/src/lib/libc/string/strchr.3 b/src/lib/libc/string/strchr.3
index 18b50301f3..d3194dffab 100644
--- a/src/lib/libc/string/strchr.3
+++ b/src/lib/libc/string/strchr.3
@@ -1,3 +1,5 @@
+.\"     $OpenBSD: strchr.3,v 1.10 2011/07/25 00:38:53 schwarze Exp $
+.\"
 .\" Copyright (c) 1990, 1991 The Regents of the University of California.
 .\" All rights reserved.
 .\"
@@ -13,11 +15,7 @@
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
-.\" 3. All advertising materials mentioning features or use of this software
+.\" 3. Neither the name of the University nor the names of its contributors
-.\"    must display the following acknowledgement:
-.\"     This product includes software developed by the University of
-.\"     California, Berkeley and its contributors.
-.\" 4. Neither the name of the University nor the names of its contributors
 .\"    may be used to endorse or promote products derived from this software
 .\"    without specific prior written permission.
 .\"
@@ -33,29 +31,27 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"     from: @(#)strchr.3      5.4 (Berkeley) 6/29/91
+.Dd $Mdocdate: July 25 2011 $
-.\"     $Id: strchr.3,v 1.1.1.1 1995/10/18 08:42:22 deraadt Exp $
-.\"
-.Dd June 29, 1991
 .Dt STRCHR 3
 .Os
 .Sh NAME
-.Nm strchr
+.Nm strchr ,
-.Nd locate character in string
+.Nm index
+.Nd locate first occurrence of a character in a string
 .Sh SYNOPSIS
 .Fd #include <string.h>
 .Ft char *
 .Fn strchr "const char *s" "int c"
+.Ft char *
+.Fn index "const char *s" "int c"
 .Sh DESCRIPTION
 The
 .Fn strchr
-function locates the first occurrence of
+function locates the first occurrence of the character
-.Ar c
+.Fa c
-in the string pointed to by
+in the string
-.Ar s .
+.Fa s .
-The terminating
+The terminating NUL character is considered part of the string.
-.Dv NULL
-character is considered part of the string.
 If
 .Fa c
 is
@@ -63,26 +59,56 @@ is
 .Fn strchr
 locates the terminating
 .Ql \e0 .
+.Pp
+The
+.Fn index
+function is an old synonym for
+.Fn strchr .
 .Sh RETURN VALUES
-The function
+The
 .Fn strchr
-returns a pointer to the located character, or
+function returns a pointer to the located character or
 .Dv NULL
 if the character does not appear in the string.
+.Sh EXAMPLES
+After the following call to
+.Fn strchr ,
+.Va p
+will point to the string
+.Qq oobar :
+.Bd -literal -offset indent
+char *p;
+char *s = "foobar";
+p = strchr(s, 'o');
+.Ed
 .Sh SEE ALSO
-.Xr index 3 ,
 .Xr memchr 3 ,
-.Xr rindex 3 ,
 .Xr strcspn 3 ,
 .Xr strpbrk 3 ,
 .Xr strrchr 3 ,
 .Xr strsep 3 ,
 .Xr strspn 3 ,
 .Xr strstr 3 ,
-.Xr strtok 3
+.Xr strtok 3 ,
+.Xr wcschr 3
 .Sh STANDARDS
 The
 .Fn strchr
-function
+function conforms to
-conforms to
 .St -ansiC .
+.Pp
+The
+.Fn index
+function is deprecated and shouldn't be used in new code.
+.Sh HISTORY
+The
+.Fn index
+function first appeared in
+.At v7 .
+The
+.Fn strchr
+function first appeared in
+.At III
+and was reimplemented for
+.Bx 4.3 Tahoe .

diff --git a/src/lib/libc/string/strchr.3 b/src/lib/libc/string/strchr.3 index 18b50301f3..d3194dffab 100644 --- a/src/lib/libc/string/strchr.3 +++ b/src/lib/libc/string/strchr.3
@@ -1,3 +1,5 @@
		1	.\" $OpenBSD: strchr.3,v 1.10 2011/07/25 00:38:53 schwarze Exp $
		2	.\"
1	.\" Copyright (c) 1990, 1991 The Regents of the University of California.	3	.\" Copyright (c) 1990, 1991 The Regents of the University of California.
2	.\" All rights reserved.	4	.\" All rights reserved.
3	.\"	5	.\"
@@ -13,11 +15,7 @@
13	.\" 2. Redistributions in binary form must reproduce the above copyright	15	.\" 2. Redistributions in binary form must reproduce the above copyright
14	.\" notice, this list of conditions and the following disclaimer in the	16	.\" notice, this list of conditions and the following disclaimer in the
15	.\" documentation and/or other materials provided with the distribution.	17	.\" documentation and/or other materials provided with the distribution.
16	.\" 3. All advertising materials mentioning features or use of this software	18	.\" 3. Neither the name of the University nor the names of its contributors
17	.\" must display the following acknowledgement:
18	.\" This product includes software developed by the University of
19	.\" California, Berkeley and its contributors.
20	.\" 4. Neither the name of the University nor the names of its contributors
21	.\" may be used to endorse or promote products derived from this software	19	.\" may be used to endorse or promote products derived from this software
22	.\" without specific prior written permission.	20	.\" without specific prior written permission.
23	.\"	21	.\"
@@ -33,29 +31,27 @@
33	.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF	31	.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
34	.\" SUCH DAMAGE.	32	.\" SUCH DAMAGE.
35	.\"	33	.\"
36	.\" from: @(#)strchr.3 5.4 (Berkeley) 6/29/91	34	.Dd $Mdocdate: July 25 2011 $
37	.\" $Id: strchr.3,v 1.1.1.1 1995/10/18 08:42:22 deraadt Exp $
38	.\"
39	.Dd June 29, 1991
40	.Dt STRCHR 3	35	.Dt STRCHR 3
41	.Os	36	.Os
42	.Sh NAME	37	.Sh NAME
43	.Nm strchr	38	.Nm strchr ,
44	.Nd locate character in string	39	.Nm index
		40	.Nd locate first occurrence of a character in a string
45	.Sh SYNOPSIS	41	.Sh SYNOPSIS
46	.Fd #include <string.h>	42	.Fd #include <string.h>
47	.Ft char *	43	.Ft char *
48	.Fn strchr "const char *s" "int c"	44	.Fn strchr "const char *s" "int c"
		45	.Ft char *
		46	.Fn index "const char *s" "int c"
49	.Sh DESCRIPTION	47	.Sh DESCRIPTION
50	The	48	The
51	.Fn strchr	49	.Fn strchr
52	function locates the first occurrence of	50	function locates the first occurrence of the character
53	.Ar c	51	.Fa c
54	in the string pointed to by	52	in the string
55	.Ar s .	53	.Fa s .
56	The terminating	54	The terminating NUL character is considered part of the string.
57	.Dv NULL
58	character is considered part of the string.
59	If	55	If
60	.Fa c	56	.Fa c
61	is	57	is
@@ -63,26 +59,56 @@ is
63	.Fn strchr	59	.Fn strchr
64	locates the terminating	60	locates the terminating
65	.Ql \e0 .	61	.Ql \e0 .
		62	.Pp
		63	The
		64	.Fn index
		65	function is an old synonym for
		66	.Fn strchr .
66	.Sh RETURN VALUES	67	.Sh RETURN VALUES
67	The function	68	The
68	.Fn strchr	69	.Fn strchr
69	returns a pointer to the located character, or	70	function returns a pointer to the located character or
70	.Dv NULL	71	.Dv NULL
71	if the character does not appear in the string.	72	if the character does not appear in the string.
		73	.Sh EXAMPLES
		74	After the following call to
		75	.Fn strchr ,
		76	.Va p
		77	will point to the string
		78	.Qq oobar :
		79	.Bd -literal -offset indent
		80	char *p;
		81	char *s = "foobar";
		82
		83	p = strchr(s, 'o');
		84	.Ed
72	.Sh SEE ALSO	85	.Sh SEE ALSO
73	.Xr index 3 ,
74	.Xr memchr 3 ,	86	.Xr memchr 3 ,
75	.Xr rindex 3 ,
76	.Xr strcspn 3 ,	87	.Xr strcspn 3 ,
77	.Xr strpbrk 3 ,	88	.Xr strpbrk 3 ,
78	.Xr strrchr 3 ,	89	.Xr strrchr 3 ,
79	.Xr strsep 3 ,	90	.Xr strsep 3 ,
80	.Xr strspn 3 ,	91	.Xr strspn 3 ,
81	.Xr strstr 3 ,	92	.Xr strstr 3 ,
82	.Xr strtok 3	93	.Xr strtok 3 ,
		94	.Xr wcschr 3
83	.Sh STANDARDS	95	.Sh STANDARDS
84	The	96	The
85	.Fn strchr	97	.Fn strchr
86	function	98	function conforms to
87	conforms to
88	.St -ansiC .	99	.St -ansiC .
		100	.Pp
		101	The
		102	.Fn index
		103	function is deprecated and shouldn't be used in new code.
		104	.Sh HISTORY
		105	The
		106	.Fn index
		107	function first appeared in
		108	.At v7 .
		109	The
		110	.Fn strchr
		111	function first appeared in
		112	.At III
		113	and was reimplemented for
		114	.Bx 4.3 Tahoe .