Date: Mon, 19 Jan 2004 13:04:15 +0200 From: Ruslan Ermilov <ru@FreeBSD.ORG> To: Peter Jeremy <peterjeremy@optushome.com.au>, src-committers@FreeBSD.ORG, cvs-src@FreeBSD.ORG, cvs-all@FreeBSD.ORG Subject: Re: cvs commit: src/lib/libc/stdio printf.3 Message-ID: <20040119110415.GE41159@FreeBSD.org.ua> In-Reply-To: <20040119092254.GA61125@VARK.homeunix.com> References: <200401190828.i0J8SUsY040770@repoman.freebsd.org> <20040119090934.GB2708@server.vk2pj.dyndns.org> <20040119092254.GA61125@VARK.homeunix.com>
next in thread | previous in thread | raw e-mail | index | archive | help
--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--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20040119110415.GE41159>