Date: Mon, 7 May 2001 05:55:41 +0900 From: "KONDOU, Kazuhiro" <k-fuji@za2.so-net.ne.jp> To: FreeBSD-gnats-submit@freebsd.org Subject: docs/27161: manual format is unstable Message-ID: <20010507055541.7ee6a8bd.k-fuji@za2.so-net.ne.jp>
next in thread | raw e-mail | index | archive | help
>Number: 27161
>Category: docs
>Synopsis: manual format is unstable
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: change-request
>Submitter-Id: current-users
>Arrival-Date: Sun May 06 14:00:00 PDT 2001
>Closed-Date:
>Last-Modified:
>Originator: KONDOU, Kazuhiro
>Release: FreeBSD 4.3-STABLE i386
>Organization:
FreeBSD Japanese Manual Translation Project
>Environment:
System:
FreeBSD 4.3-STABLE, with man distribution
>Description:
Some parts of manuals in section 3 are not formatted in
standardized.
I want to write any articles about return values into RETURN
VALUES section, and DESCRIPTION section has only functional
descriptions.
Examplly, strcmp(3) has DESCRIPTION and RETURN VALUES section.
but, very likely function strcasecmp(3) has only DESCRIPTION
section.
>How-To-Repeat:
do "man 3 strcmp" and "man 3 strcasecmp"
>Fix:
--- strcasecmp.3 Mon May 7 05:44:50 2001
+++ strcasecmp.new.3 Mon May 7 05:47:41 2001
@@ -58,8 +58,19 @@
compare the null-terminated strings
.Fa s1
and
-.Fa s2
-and return an integer greater than, equal to, or less than 0,
+.Fa s2 .
+.Pp
+The
+.Fn strncasecmp
+compares at most
+.Fa len
+characters.
+.Sh RETURN VALUES
+The
+.Fn strcasecmp
+and
+.Fn strncasecmp
+return an integer greater than, equal to, or less than 0,
according as
.Fa s1
is lexicographically greater than, equal to, or less than
@@ -70,12 +81,6 @@
.Sq Li \e200
is greater than
.Ql \e0 .
-.Pp
-The
-.Fn strncasecmp
-compares at most
-.Fa len
-characters.
.Sh SEE ALSO
.Xr bcmp 3 ,
.Xr memcmp 3 ,
>Release-Note:
>Audit-Trail:
>Unformatted:
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010507055541.7ee6a8bd.k-fuji>