From owner-freebsd-doc Fri Mar 8 18: 0: 7 2002 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 CEB9C37B400 for ; Fri, 8 Mar 2002 18:00:02 -0800 (PST) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.6/8.11.6) id g29202d47534; Fri, 8 Mar 2002 18:00:02 -0800 (PST) (envelope-from gnats) Date: Fri, 8 Mar 2002 18:00:02 -0800 (PST) Message-Id: <200203090200.g29202d47534@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: Dima Dorfman Subject: Re: docs/35644: lo(4) page presumes familiarity with printf. Reply-To: Dima Dorfman Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org The following reply was made to PR docs/35644; it has been noted by GNATS. From: Dima Dorfman To: swear@blarg.net Cc: FreeBSD-gnats-submit@freebsd.org Subject: Re: docs/35644: lo(4) page presumes familiarity with printf. Date: Sat, 09 Mar 2002 01:57:07 +0000 "Gary W. Swearingen" wrote: > > >Number: 35644 > >Category: docs > >Synopsis: lo(4) page presumes familiarity with printf. > >Description: > The lo(4) man page presumes familiarity with "printf" when it uses "%d" > in two places. Bad presumption. At least the first usage ("lo%d") is idiomatic; almost all manual pages (esp. those for drivers) in section 4 use it. Grep'ing for "%d" through sections 1, 4, 6, and 8 returns over 500 matches; some of these are no doubt not what we're looking for, but many are. I think it's reasonable to assume that the reader can mentally replace "%d" with "an integer". I wouldn't object to this being documented in some of the intro(X) manual pages, but I don't think it's wise to change all the pages that use this notation. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message