From owner-cvs-all@FreeBSD.ORG  Mon Jan 19 01:23:23 2004
Return-Path: <owner-cvs-all@FreeBSD.ORG>
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 9643F16A4CE; Mon, 19 Jan 2004 01:23:23 -0800 (PST)
Received: from VARK.homeunix.com (adsl-68-124-78-95.dsl.pltn13.pacbell.net
	[68.124.78.95])	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 7EC3443D1F; Mon, 19 Jan 2004 01:23:21 -0800 (PST)
	(envelope-from das@FreeBSD.ORG)
Received: from VARK.homeunix.com (localhost [127.0.0.1])
	by VARK.homeunix.com (8.12.10/8.12.10) with ESMTP id i0J9MsKu061165;
	Mon, 19 Jan 2004 01:22:54 -0800 (PST)
	(envelope-from das@FreeBSD.ORG)
Received: (from das@localhost)
	by VARK.homeunix.com (8.12.10/8.12.10/Submit) id i0J9MsTk061164;
	Mon, 19 Jan 2004 01:22:54 -0800 (PST)
	(envelope-from das@FreeBSD.ORG)
Date: Mon, 19 Jan 2004 01:22:54 -0800
From: David Schultz <das@FreeBSD.ORG>
To: Peter Jeremy <peterjeremy@optushome.com.au>
Message-ID: <20040119092254.GA61125@VARK.homeunix.com>
Mail-Followup-To: Peter Jeremy <peterjeremy@optushome.com.au>,
	src-committers@FreeBSD.ORG, cvs-src@FreeBSD.ORG, cvs-all@FreeBSD.ORG
References: <200401190828.i0J8SUsY040770@repoman.freebsd.org>
	<20040119090934.GB2708@server.vk2pj.dyndns.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20040119090934.GB2708@server.vk2pj.dyndns.org>
cc: cvs-src@FreeBSD.ORG
cc: src-committers@FreeBSD.ORG
cc: cvs-all@FreeBSD.ORG
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 <cvs-all.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-all>,
	<mailto:cvs-all-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/cvs-all>
List-Post: <mailto:cvs-all@freebsd.org>
List-Help: <mailto:cvs-all-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-all>,
	<mailto:cvs-all-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Mon, 19 Jan 2004 09:23:23 -0000

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 
> >  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.