From owner-cvs-all@FreeBSD.ORG  Mon Jan 19 01:09:37 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 75F8716A4CE; Mon, 19 Jan 2004 01:09:37 -0800 (PST)
Received: from server.vk2pj.dyndns.org
	(c211-30-75-229.belrs2.nsw.optusnet.com.au [211.30.75.229])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 3359543D2F; Mon, 19 Jan 2004 01:09:35 -0800 (PST)
	(envelope-from peterjeremy@optushome.com.au)
Received: from server.vk2pj.dyndns.org (localhost.vk2pj.dyndns.org
	[127.0.0.1])i0J99YPf002973;	Mon, 19 Jan 2004 20:09:34 +1100 (EST)
	(envelope-from peter@server.vk2pj.dyndns.org)
Received: (from peter@localhost)
	by server.vk2pj.dyndns.org (8.12.10/8.12.10/Submit) id i0J99Yde002972;
	Mon, 19 Jan 2004 20:09:34 +1100 (EST)
	(envelope-from peter)
Date: Mon, 19 Jan 2004 20:09:34 +1100
From: Peter Jeremy <peterjeremy@optushome.com.au>
To: David Schultz <das@freebsd.org>
Message-ID: <20040119090934.GB2708@server.vk2pj.dyndns.org>
References: <200401190828.i0J8SUsY040770@repoman.freebsd.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <200401190828.i0J8SUsY040770@repoman.freebsd.org>
User-Agent: Mutt/1.4.1i
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:09:37 -0000

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.

Peter