From owner-freebsd-doc@FreeBSD.ORG Tue Mar 21 18:20:18 2006 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 6D30416A422 for ; Tue, 21 Mar 2006 18:20:18 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 067D843D45 for ; Tue, 21 Mar 2006 18:20:17 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.4/8.13.4) with ESMTP id k2LIKFon022696 for ; Tue, 21 Mar 2006 18:20:15 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.4/8.13.4/Submit) id k2LIKFik022695; Tue, 21 Mar 2006 18:20:15 GMT (envelope-from gnats) Resent-Date: Tue, 21 Mar 2006 18:20:15 GMT Resent-Message-Id: <200603211820.k2LIKFik022695@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, "Ronald F.Guilmette" Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 08BD216A400 for ; 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 ; 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" To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/94803: Slightly confusing/misleading man page for `ffs' function X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: "Ronald F.Guilmette" List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 21 Mar 2006 18:20:18 -0000 >Number: 94803 >Category: docs >Synopsis: Slightly confusing/misleading man page for `ffs' function >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Tue Mar 21 18:20:14 GMT 2006 >Closed-Date: >Last-Modified: >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: >Unformatted: