Bug 94803

Summary:	Slightly confusing/misleading man page for `ffs' function
Product:	Documentation	Reporter:	Ronald F. Guilmette <rfg>
Component:	Books & Articles	Assignee:	ru <ru>
Status:	Closed FIXED
Severity:	Affects Only Me
Priority:	Normal
Version:	Latest
Hardware:	Any
OS:	Any

Description Ronald F. Guilmette 2006-03-21 18:20:14 UTC

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.

Fix: 

Change ``rightmost'' to ``lowest order''.
How-To-Repeat: 
Look at the man page for ffs.

Comment 1 ru freebsd_committer

2006-10-12 16:08:48 UTC

State Changed
From-To: open->patched

Fixed in 7.0-CURRENT, thanks!

Comment 2 ru freebsd_committer

2006-10-12 16:08:48 UTC

Responsible Changed
From-To: freebsd-doc->ru

Comment 3 dfilter service freebsd_committer

2006-10-12 16:09:00 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"

Comment 4 ru freebsd_committer

2006-10-16 13:03:22 UTC

State Changed
From-To: patched->closed

Merged into RELENG_6.

Comment 5 dfilter service freebsd_committer

2006-10-16 13:07:37 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"