From owner-freebsd-doc  Sun May  6 14: 0: 7 2001
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 36B1237B424
	for <freebsd-doc@freebsd.org>; Sun,  6 May 2001 14:00:01 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.11.1/8.11.1) id f46L01n70181;
	Sun, 6 May 2001 14:00:01 -0700 (PDT)
	(envelope-from gnats)
Received: from mgate05.so-net.ne.jp (mgate05.so-net.ne.jp [210.139.254.152])
	by hub.freebsd.org (Postfix) with ESMTP id E659237B423
	for <FreeBSD-gnats-submit@freebsd.org>; Sun,  6 May 2001 13:55:38 -0700 (PDT)
	(envelope-from k-fuji@za2.so-net.ne.jp)
Received: from mail.za2.so-net.ne.jp (mspool13.so-net.ne.jp [210.139.248.13])
	by mgate05.so-net.ne.jp (8.8.8+3.0Wbeta9/3.6W01041612) with ESMTP id FAA24408
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 7 May 2001 05:55:37 +0900 (JST)
Received: from feena.ancientlibrary.net ([210.255.148.41])
	by mail.za2.so-net.ne.jp (8.9.3/3.7W01022316) with SMTP id FAA28893
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 7 May 2001 05:55:37 +0900 (JST)
Message-Id: <20010507055541.7ee6a8bd.k-fuji@za2.so-net.ne.jp>
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
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org


>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