From owner-cvs-all@FreeBSD.ORG Mon Jan 19 22:39:08 2004 Return-Path: Delivered-To: cvs-all@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 1EFF816A4CE; Mon, 19 Jan 2004 22:39:08 -0800 (PST) Received: from cirb503493.alcatel.com.au (c211-30-75-229.belrs2.nsw.optusnet.com.au [211.30.75.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id A816D43D1F; Mon, 19 Jan 2004 22:39:05 -0800 (PST) (envelope-from PeterJeremy@optushome.com.au) Received: from cirb503493.alcatel.com.au (localhost.alcatel.com.au [127.0.0.1])i0K6d4e3003793; Tue, 20 Jan 2004 17:39:04 +1100 (EST) (envelope-from jeremyp@cirb503493.alcatel.com.au) Received: (from jeremyp@localhost)i0K6d48N003792; Tue, 20 Jan 2004 17:39:04 +1100 (EST) (envelope-from jeremyp) Date: Tue, 20 Jan 2004 17:39:04 +1100 From: Peter Jeremy To: src-committers@FreeBSD.ORG, cvs-src@FreeBSD.ORG, cvs-all@FreeBSD.ORG Message-ID: <20040120063904.GF908@cirb503493.alcatel.com.au> References: <200401190828.i0J8SUsY040770@repoman.freebsd.org> <20040119090934.GB2708@server.vk2pj.dyndns.org> <20040119092254.GA61125@VARK.homeunix.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20040119092254.GA61125@VARK.homeunix.com> User-Agent: Mutt/1.4.1i Subject: Re: cvs commit: src/lib/libc/stdio printf.3 X-BeenThere: cvs-all@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: CVS commit messages for the entire tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Jan 2004 06:39:08 -0000 On Mon, Jan 19, 2004 at 01:22:54AM -0800, David Schultz wrote: >On Mon, Jan 19, 2004, I wrote: >> On Mon, Jan 19, 2004 at 12:28:30AM -0800, David Schultz wrote: >> >das 2004/01/19 00:28:30 PST >> > >> > FreeBSD src repository >> > >> > Modified files: >> > lib/libc/stdio printf.3 >> > Log: >> > Bring the *printf(3) documentation up to date with the code: >> > >> > - Update and improve the documentation for %[aA] >> ... >> > o Clarify that the exponent field represents a decimal exponent of 2. >> >> The >> .Cm p >> is a literal character >> -.Ql p ; >> -the exponent is preceded by a positive or negative sign >> -and is represented in decimal, using only enough characters >> -to represent the exponent. >> +.Ql p , >> +and the exponent consists of a positive or negative sign >> +followed by a decimal number representing an exponent of 2. >> >> Maybe it's just me but I still don't find that wording very clear. >> I'm still not totally happy with the following but I think changing >> '2' to 'base-2' makes it a bit clearer: >> >> .Ql p , >> and the exponent consists of a positive or negative sign >> followed by a decimal number representing the base-2 exponent. > >Hmm...to me, ``base-2 foo'' means ``foo represented in base 2'', >so I'm not too happy with that wording. It's hard to think of >something better, though; ``power of 2'' is also easily >misinterpreted. I'm open to other suggestions, though. I asked a colleague at work and he also felt that the original wording was clear. It seems I'm in a minority of one so I'll withdraw my suggestion. Peter