From swear@blarg.net  Thu Mar  7 12:06:41 2002
Return-Path: <swear@blarg.net>
Received: from lists.blarg.net (lists.blarg.net [206.124.128.17])
	by hub.freebsd.org (Postfix) with ESMTP id 8551137B402
	for <FreeBSD-gnats-submit@freebsd.org>; Thu,  7 Mar 2002 12:06:40 -0800 (PST)
Received: from thig.blarg.net (thig.blarg.net [206.124.128.18])
	by lists.blarg.net (Postfix) with ESMTP id 31ACCBD80
	for <FreeBSD-gnats-submit@freebsd.org>; Thu,  7 Mar 2002 12:06:40 -0800 (PST)
Received: from localhost.localdomain ([206.124.139.115])
	by thig.blarg.net (8.9.3/8.9.3) with ESMTP id MAA02161
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 7 Mar 2002 12:06:39 -0800
Received: (from jojo@localhost)
	by localhost.localdomain (8.11.6/8.11.3) id g27K9ql46602;
	Thu, 7 Mar 2002 12:09:52 -0800 (PST)
	(envelope-from swear@blarg.net)
Message-Id: <sok7socf73.7so@localhost.localdomain>
Date: 07 Mar 2002 12:09:52 -0800
From: "Gary W. Swearingen" <swear@blarg.net>
Reply-To: swear@blarg.net
To: FreeBSD-gnats-submit@freebsd.org
Subject: lo(4) page presumes familiarity with printf.
X-GNATS-Notify:

>Number:         35644
>Category:       docs
>Synopsis:       lo(4) page presumes familiarity with printf.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Thu Mar 07 12:10:01 PST 2002
>Closed-Date:    Fri Apr 14 20:13:08 GMT 2006
>Last-Modified:  Fri Apr 14 20:13:08 GMT 2006
>Originator:     Gary W. Swearingen
>Release:        FreeBSD 4.5-STABLE i386
>Organization:
none
>Environment:
n/a
================
>Description:

The lo(4) man page presumes familiarity with "printf" when it uses "%d"
in two places.  Bad presumption.  It also makes the man page look rather
like it has had file corruption or formatting errors.
================
>How-To-Repeat:
n/a
================
>Fix:

Replace the esoteric "%d" with the much more common "#" in two places.
>Release-Note:
>Audit-Trail:

From: Dima Dorfman <dima@trit.org>
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" <swear@blarg.net> 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.

From: swear@blarg.net (Gary W. Swearingen)
To: Dima Dorfman <dima@trit.org>
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/35644: lo(4) page presumes familiarity with printf.
Date: 08 Mar 2002 22:49:15 -0800

 Dima Dorfman <dima@trit.org> writes:
 
 > 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.
 
 The "to much work" argument is OK by me, though I think it's really a
 nasty, ugly thing outside of sections 2 & 3 which can presume knowledge
 of "C" while I'd like to hope that many users know nothing of it.
 
 Documenting the esoteric symbol is a poor substitute for using a symbol
 understood by almost everybody, as many will not read or remember it,
 but I guess it's better than nothing.
 
 As to where it's documented, it seems to me that the man(1) page would
 be better than the intro(*) pages, but either will do OK.

From: Maxim Konovalov <maxim@macomnet.ru>
To: "Gary W. Swearingen" <swear@blarg.net>
Cc: bug-followup@freebsd.org
Subject: docs/35644
Date: Sat, 15 Apr 2006 00:06:54 +0400 (MSD)

 Gary,
 
 Is %d in man pages still esoteric for you? :-)
 
 -- 
 Maxim Konovalov
State-Changed-From-To: open->closed 
State-Changed-By: maxim 
State-Changed-When: Fri Apr 14 20:12:45 UTC 2006 
State-Changed-Why:  
The submitter's email bounces. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=35644 
>Unformatted:
