new version, reference specific man pages

SCCS-vsn: lib/libc/string/string.3 6.6

diff --git a/usr/src/lib/libc/string/string.3 b/usr/src/lib/libc/string/string.3
index 064aaed..41d8b91 100644 (file)
--- a/usr/src/lib/libc/string/string.3
+++ b/usr/src/lib/libc/string/string.3
@@ -1,81 +1,109 @@
-.\" Copyright (c) 1980 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1990 The Regents of the University of California.
+.\" All rights reserved.

 .\"
 .\"

-.\"    @(#)string.3    6.5 (Berkeley) %G%
+.\" This code is derived from software contributed to Berkeley by
+.\" Chris Torek.

 .\"
 .\"

-.TH STRING 3  ""
+.\" %sccs.include.redist.man%
+.\"
+.\"    @(#)string.3    6.6 (Berkeley) %G%
+.\"
+.TH STRING 3 ""

 .UC 4
 .SH NAME
 .UC 4
 .SH NAME

-strcat, strncat, strcmp, strncmp, strcasecmp, strncasecmp, strcpy,
-strncpy, strlen, index, rindex \- string operations
+strcat, strncat, strchr, strrchr, strcmp, strncmp, strcasecmp,
+strncasecmp, strcpy, strncpy, strerror, strlen, strpbrk, strsep,
+strspn, strcspn, strstr, strtok, index, rindex \- string operations

 .SH SYNOPSIS
 .nf
 .SH SYNOPSIS
 .nf

-.B #include <strings.h>
-.PP
-.B char *strcat(s, append)
-.B char *s, *append;
-.PP
-.B char *strncat(s, append, count)
-.B char *s, *append;
-.B int count;
-.PP
-.B strcmp(s1, s2)
-.B char *s1, *s2;
-.PP
-.B strncmp(s1, s2, count)
-.B char *s1, *s2;
-.B int count;
-.PP
-.B strcasecmp(s1, s2)
-.B char *s1, *s2;
-.PP
-.B strncasecmp(s1, s2, count)
-.B char *s1, *s2;
-.B int count;
-.PP
-.B char *strcpy(to, from)
-.B char *to, *from;
-.PP
-.B char *strncpy(to, from, count)
-.B char *to, *from;
-.B int count;
-.PP
-.B strlen(s)
-.B char *s;
-.PP
-.B char *index(s, c)
-.B char *s, c;
-.PP
-.B char *rindex(s, c)
-.B char *s, c;
+.ft B
+#include <string.h>
+
+char *
+strcat(char *s, const char * append);
+
+char *
+strncat(char *s, const char *append, size_t count);
+
+char *
+strchr(const char *s, int c);
+
+char *
+strrchr(const char *s, int c);
+
+strcmp(const char *s1, const char *s2);
+
+strncmp(const char *s1, const char *s2, size_t count);
+
+strcasecmp(const char *s1, const char *s2);
+
+strncasecmp(const char *s1, const char *s2, size_t count);
+
+char *
+strcpy(char *dst, const char *src);
+
+char *
+strncpy(char *dst, const char *src, size_t count);
+
+char *
+strerror(int errno);
+
+strlen(const char *s);
+
+char *
+strpbrk(const char *s, const char *charset);
+
+char *
+strsep(char *stringp, const char *delim);
+
+size_t
+strspn(const char *s, const char *charset);
+
+size_t
+strcspn(const char *s, const char *charset);
+
+char *
+strstr(const char *big, const char *little);
+
+char *
+strtok(char *s, const char *delim);
+
+char *
+index(const char *s, int c);
+
+char *
+rindex(const char *s, int c);
+.ft R

 .fi
 .SH DESCRIPTION
 These functions operate on null-terminated strings.
 .fi
 .SH DESCRIPTION
 These functions operate on null-terminated strings.

-They do not check for overflow of any receiving string.
-.PP
-\fIStrcat\fP appends a copy of string \fIappend\fP to the end of string
-\fIs\fP. \fIStrncat\fP copies at most \fIcount\fP characters.  Both
-return a pointer to the null-terminated result.
-.PP
-\fIStrcmp\fP compares its arguments and returns an integer greater than,
-equal to, or less than 0, according as \fIs1\fP is lexicographically
-greater than, equal to, or less than \fIs2\fP.  \fIStrncmp\fP makes the
-same comparison but looks at at most \fIcount\fP characters.
-\fIStrcasecmp\fP and \fIstrncasecmp\fP are identical in function, but are
-case insensitive.  The returned lexicographic difference reflects a
-conversion to lower-case.
-.PP
-\fIStrcpy\fP copies string \fIfrom\fP to \fIto\fP, stopping after the
-null character has been moved.  \fIStrncpy\fP copies exactly \fIcount\fP
-characters, appending nulls if \fIfrom\fP is less than \fIcount\fP
-characters in length; the target may not be null-terminated if the
-length of \fIfrom\fP is \fIcount\fP or more.  Both return \fIto\fP.
-.PP
-\fIStrlen\fP returns the number of non-null characters in \fIs\fP.

 .PP
 .PP

-.I Index
-.RI ( rindex )
-returns a pointer to the first (last) occurrence of character 
-\fIc\fP in string \fIs\fP or zero if \fIc\fP does not occur in
-the string.  Setting \fIc\fP to NULL works.
+See the specific manual pages for more information.
+.PP
+Except as noted in their specific manual pages,
+they do not check for overflow of any destination
+string.
+.SH SEE\ ALSO
+index(3), strcat(3), strncat(3), strchr(3), strrchr(3), strcmp(3),
+strncmp(3), strcasecmp(3), strncasecmp(3), strcpy(3), strncpy(3),
+strerror(3), strlen(3), strpbrk(3), strsep(3), strspn(3), strcspn(3),
+strstr(3), strtok(3), rindex(3)
+.SH STANDARDS
+.IR Strcat ,
+.IR strncat ,
+.IR strchr ,
+.IR strrchr ,
+.IR strcmp ,
+.IR strncmp ,
+.IR strcpy ,
+.IR strncpy ,
+.IR strerror ,
+.IR strlen ,
+.IR strpbrk ,
+.IR strsep ,
+.IR strspn ,
+.IR strcspn ,
+.IR strstr ,
+and
+.IR strtok
+conform to ANSI X3.159-1989 (``ANSI C'').