From rfg@monkeys.com  Tue Mar 21 18:19:44 2006
Return-Path: <rfg@monkeys.com>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 08BD216A400
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 21 Mar 2006 18:19:44 +0000 (UTC)
	(envelope-from rfg@monkeys.com)
Received: from segfault-outgoing-helo.monkeys.com (segfault.monkeys.com [66.60.159.24])
	by mx1.FreeBSD.org (Postfix) with ESMTP id A127843D48
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 21 Mar 2006 18:19:42 +0000 (GMT)
	(envelope-from rfg@monkeys.com)
Received: by segfault.monkeys.com (Postfix, from userid 1237)
	id A092D54AA; Tue, 21 Mar 2006 10:19:39 -0800 (PST)
Message-Id: <20060321181939.A092D54AA@segfault.monkeys.com>
Date: Tue, 21 Mar 2006 10:19:39 -0800 (PST)
From: Ronald F.Guilmette <rfg@monkeys.com>
Reply-To: Ronald F.Guilmette <rfg@monkeys.com>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: Slightly confusing/misleading man page for `ffs' function
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         94803
>Category:       docs
>Synopsis:       Slightly confusing/misleading man page for `ffs' function
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    ru
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Mar 21 18:20:14 GMT 2006
>Closed-Date:    Mon Oct 16 12:03:35 GMT 2006
>Last-Modified:  Mon Oct 16 12:10:44 GMT 2006
>Originator:     Ronald F. Guilmette
>Release:        FreeBSD 4.10-RELEASE i386
>Organization:
Infinite Monkeys & Co. LLC
>Environment:
System: FreeBSD segfault.monkeys.com 4.10-RELEASE FreeBSD 4.10-RELEASE #0: Sun May 1 22:19:07 PDT 2005 rfg@segfault.monkeys.com:/usr/src/sys/compile/rfg20050501 i386


>Description:

The man page for the `ffs' C-library function says that the bits in the
argument integer are numbered (by ffs) ``starting from the rightmost bit''.

Unfortunately, ``rightmost'' is not an adequately descriptive term in this
case, especially given that for some architectures, what is commonly referred
to as the ``rightnost  bit'' may in fact be the HIGHEST ORDER bit in a given
integer.

>How-To-Repeat:

Look at the man page for ffs.

>Fix:

Change ``rightmost'' to ``lowest order''.
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->patched 
State-Changed-By: ru 
State-Changed-When: Thu Oct 12 15:08:48 UTC 2006 
State-Changed-Why:  
Fixed in 7.0-CURRENT, thanks! 


Responsible-Changed-From-To: freebsd-doc->ru 
Responsible-Changed-By: ru 
Responsible-Changed-When: Thu Oct 12 15:08:48 UTC 2006 
Responsible-Changed-Why:  

http://www.freebsd.org/cgi/query-pr.cgi?pr=94803 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/94803: commit references a PR
Date: Thu, 12 Oct 2006 15:09:00 +0000 (UTC)

 ru          2006-10-12 15:08:41 UTC
 
   FreeBSD src repository
 
   Modified files:
     lib/libc/string      ffs.3 
   Log:
   Don't say "rightmost" when referring to the least significant bit.
   
   PR:             docs/94803
   MFC after:      3 days
   
   Revision  Changes    Path
   1.10      +5 -4      src/lib/libc/string/ffs.3
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: patched->closed 
State-Changed-By: ru 
State-Changed-When: Mon Oct 16 12:03:22 UTC 2006 
State-Changed-Why:  
Merged into RELENG_6. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=94803 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/94803: commit references a PR
Date: Mon, 16 Oct 2006 12:07:37 +0000 (UTC)

 ru          2006-10-16 12:03:18 UTC
 
   FreeBSD src repository
 
   Modified files:        (Branch: RELENG_6)
     lib/libc/string      ffs.3 
   Log:
   MFC: 1.10: Don't say "rightmost" when referring to the least significant bit.
   
   PR:             docs/94803
   Approved by:    re (hrs)
   
   Revision  Changes    Path
   1.9.8.1   +5 -4      src/lib/libc/string/ffs.3
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
>Unformatted:
