From owner-cvs-src@FreeBSD.ORG Mon Jan 19 03:04:24 2004 Return-Path: Delivered-To: cvs-src@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id A8EBE16A4CE; Mon, 19 Jan 2004 03:04:24 -0800 (PST) Received: from phantom.cris.net (phantom.cris.net [212.110.130.74]) by mx1.FreeBSD.org (Postfix) with ESMTP id C561E43D2F; Mon, 19 Jan 2004 03:04:12 -0800 (PST) (envelope-from ru@FreeBSD.org.ua) Received: from phantom.cris.net (ru@localhost [127.0.0.1]) by phantom.cris.net (8.12.10/8.12.10) with ESMTP id i0JB4Njm042722; Mon, 19 Jan 2004 13:04:28 +0200 (EET) (envelope-from ru@FreeBSD.org.ua) Received: (from ru@localhost) by phantom.cris.net (8.12.10/8.12.10/Submit) id i0JB4IQ7042707; Mon, 19 Jan 2004 13:04:18 +0200 (EET) (envelope-from ru) Date: Mon, 19 Jan 2004 13:04:15 +0200 From: Ruslan Ermilov To: Peter Jeremy , src-committers@FreeBSD.ORG, cvs-src@FreeBSD.ORG, cvs-all@FreeBSD.ORG Message-ID: <20040119110415.GE41159@FreeBSD.org.ua> References: <200401190828.i0J8SUsY040770@repoman.freebsd.org> <20040119090934.GB2708@server.vk2pj.dyndns.org> <20040119092254.GA61125@VARK.homeunix.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="Yb+qhiCg54lqZFXW" Content-Disposition: inline In-Reply-To: <20040119092254.GA61125@VARK.homeunix.com> User-Agent: Mutt/1.5.5.1i Subject: Re: cvs commit: src/lib/libc/stdio printf.3 X-BeenThere: cvs-src@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: CVS commit messages for the src tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Jan 2004 11:04:24 -0000 --Yb+qhiCg54lqZFXW Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Mon, Jan 19, 2004 at 01:22:54AM -0800, David Schultz wrote: > On Mon, Jan 19, 2004, Peter Jeremy 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=20 > > > Log: > > > Bring the *printf(3) documentation up to date with the code: > > > =20 > > > - Update and improve the documentation for %[aA] > > ... > > > o Clarify that the exponent field represents a decimal exponent of= 2. > >=20 > > 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. > >=20 > > 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: > >=20 > > .Ql p , > > and the exponent consists of a positive or negative sign > > followed by a decimal number representing the base-2 exponent. >=20 > 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. >=20 POSIX says "the decimal exponent of 2", and it sounds pretty legal in mathematics, at least in this part of the world. ;) Cheers, --=20 Ruslan Ermilov FreeBSD committer ru@FreeBSD.org --Yb+qhiCg54lqZFXW Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFAC7mvUkv4P6juNwoRAn9FAJ9Ny9AEiiPdWNvI3fZzI8MUwcxbawCffmPT J+bC0JOYh+aYA4Mbsxg/BQ8= =AF9m -----END PGP SIGNATURE----- --Yb+qhiCg54lqZFXW--