Add strings(3), collecting information about strings.h.

Add Xr for it to string(3).

XXX: if someone could make a HISTORY section, I'd appreciate it

distrib/sets/lists/comp/mi

@@ -1,4 +1,4 @@
-#	$NetBSD: mi,v 1.1003 2007/02/16 17:23:53 hannken Exp $
+#	$NetBSD: mi,v 1.1004 2007/02/17 09:32:57 wiz Exp $
 ./etc/mtree/set.comp				comp-sys-root
 ./usr/bin/addr2line				comp-debug-bin		bfd
 ./usr/bin/ar					comp-util-bin		bfd
@@ -1824,10 +1824,10 @@
 ./usr/include/sys/midiio.h			comp-c-include
 ./usr/include/sys/mman.h			comp-c-include
 ./usr/include/sys/mount.h			comp-c-include
-./usr/include/sys/mutex.h			comp-c-include
 ./usr/include/sys/msg.h				comp-c-include
 ./usr/include/sys/msgbuf.h			comp-c-include
 ./usr/include/sys/mtio.h			comp-c-include
+./usr/include/sys/mutex.h			comp-c-include
 ./usr/include/sys/namei.h			comp-c-include
 ./usr/include/sys/null.h			comp-c-include
 ./usr/include/sys/optstr.h			comp-obsolete		obsolete
@@ -5966,6 +5966,7 @@
 ./usr/share/man/cat3/string.0			comp-c-catman		.cat
 ./usr/share/man/cat3/string_to_flags.0		comp-c-catman		.cat
 ./usr/share/man/cat3/stringlist.0		comp-c-catman		.cat
+./usr/share/man/cat3/strings.0			comp-c-catman		.cat
 ./usr/share/man/cat3/strlcat.0			comp-c-catman		.cat
 ./usr/share/man/cat3/strlcpy.0			comp-c-catman		.cat
 ./usr/share/man/cat3/strlen.0			comp-c-catman		.cat
@@ -6728,8 +6729,8 @@
 ./usr/share/man/cat9/cv.0			comp-sys-catman		.cat
 ./usr/share/man/cat9/cv_broadcast.0		comp-sys-catman		.cat
 ./usr/share/man/cat9/cv_destroy.0		comp-sys-catman		.cat
-./usr/share/man/cat9/cv_init.0			comp-sys-catman		.cat
 ./usr/share/man/cat9/cv_has_waiters.0		comp-sys-catman		.cat
+./usr/share/man/cat9/cv_init.0			comp-sys-catman		.cat
 ./usr/share/man/cat9/cv_signal.0		comp-sys-catman		.cat
 ./usr/share/man/cat9/cv_timedwait.0		comp-sys-catman		.cat
 ./usr/share/man/cat9/cv_timedwait_sig.0		comp-sys-catman		.cat
@@ -10283,6 +10284,7 @@
 ./usr/share/man/man3/string.3			comp-c-man		.man
 ./usr/share/man/man3/string_to_flags.3		comp-c-man		.man
 ./usr/share/man/man3/stringlist.3		comp-c-man		.man
+./usr/share/man/man3/strings.3			comp-c-man		.man
 ./usr/share/man/man3/strlcat.3			comp-c-man		.man
 ./usr/share/man/man3/strlcpy.3			comp-c-man		.man
 ./usr/share/man/man3/strlen.3			comp-c-man		.man

lib/libc/string/Makefile.inc

@@ -1,5 +1,5 @@
 #	from: @(#)Makefile.inc	8.1 (Berkeley) 6/4/93
-#	$NetBSD: Makefile.inc,v 1.66 2006/10/13 17:28:09 tnozaki Exp $
+#	$NetBSD: Makefile.inc,v 1.67 2007/02/17 09:32:58 wiz Exp $
 
 # string sources
 .PATH: ${ARCHDIR}/string ${.CURDIR}/string
@@ -55,7 +55,7 @@ SRCS+=	strrchr.c
 MAN+=	bm.3 bcmp.3 bcopy.3 bstring.3 bzero.3 ffs.3 index.3 \
 	memccpy.3 memchr.3 memcmp.3 memcpy.3 memmem.3 memmove.3	memset.3 \
 	rindex.3 strcasecmp.3 strcat.3 strchr.3 strcmp.3 strcoll.3 \
-	strcpy.3 strcspn.3 strdup.3 strerror.3 string.3 strlcpy.3 \
+	strcpy.3 strcspn.3 strdup.3 strerror.3 string.3 strings.3 strlcpy.3 \
 	strlen.3 strmode.3 strpbrk.3 strrchr.3 strsep.3 \
 	strsignal.3 strspn.3 strstr.3 strtok.3 strxfrm.3 \
 	swab.3 wcstok.3 wcswidth.3 wmemchr.3 wcsdup.3 wcscasecmp.3

lib/libc/string/string.3

@@ -28,9 +28,9 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     from: @(#)string.3	8.2 (Berkeley) 12/11/93
-.\"	$NetBSD: string.3,v 1.14 2007/02/17 09:00:37 wiz Exp $
+.\"	$NetBSD: string.3,v 1.15 2007/02/17 09:32:58 wiz Exp $
 .\"
-.Dd February 9, 2007
+.Dd February 17, 2007
 .Dt STRING 3
 .Os
 .Sh NAME
@@ -140,6 +140,7 @@ for size limitations.
 .Xr strcspn 3 ,
 .Xr strdup 3 ,
 .Xr strerror 3 ,
+.Xr strings 3 ,
 .Xr strlcat 3 ,
 .Xr strlen 3 ,
 .Xr strpbrk 3 ,

lib/libc/string/strings.3

@@ -0,0 +1,98 @@
+.\" $NetBSD: strings.3,v 1.1 2007/02/17 09:32:58 wiz Exp $
+.\"
+.\" Copyright (c) 2007 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Thomas Klausner.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 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.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
+.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+.\" POSSIBILITY OF SUCH DAMAGE.
+.\"
+.Dd February 17, 2007
+.Dt STRINGS 3
+.Os
+.Sh NAME
+.Nm bcmp ,
+.Nm bcopy ,
+.Nm bzero ,
+.Nm ffs ,
+.Nm index ,
+.Nm rindex ,
+.Nm strcasecmp ,
+.Nm strncasecmp
+.Nd string operations
+.Sh LIBRARY
+.Lb libc
+.Sh SYNOPSIS
+.In strings.h
+.Ft int
+.Fn bcmp "const void *b1" "const void *b2" "size_t len"
+.Ft void
+.Fn bcopy "const void *src" "void *dst" "size_t len"
+.Ft void
+.Fn bzero "void *b" "size_t len"
+.Ft int
+.Fn ffs "int value"
+.Ft char *
+.Fn index "const char *s" "int c"
+.Ft char *
+.Fn rindex "const char *s" "int c"
+.Ft int
+.Fn strcasecmp "const char *s1" "const char *s2"
+.Ft int
+.Fn strncasecmp "const char *s1" "const char *s2" "size_t len"
+.Sh DESCRIPTION
+These functions all live in the
+.Pa strings.h
+header file.
+Except for
+.Fn ffs ,
+they operate on strings.
+.Fn index ,
+.Fn rindex ,
+and
+.Fn strcasecmp
+need nul-terminated strings.
+.Pp
+See the specific manual pages for more information.
+.Pp
+See
+.Xr string 3
+for string functions that follow
+.St -ansiC
+or
+.St -isoC-99 ,
+.Xr bstring 3
+for functions that operate on strings that are not nul-terminated, and
+.Xr bitstring 3
+for bit-string manipulation macros.
+.Sh SEE ALSO
+.Xr bcmp 3 ,
+.Xr bcopy 3 ,
+.Xr bitstring 3 ,
+.Xr bstring 3 ,
+.Xr bzero 3 ,
+.Xr ffs 3 ,
+.Xr index 3 ,
+.Xr rindex 3 ,
+.Xr strcasecmp 3 ,
+.Xr string 3