From owner-cvs-all@FreeBSD.ORG Mon Jan 19 13:05:27 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 6F81C16A4CE; Mon, 19 Jan 2004 13:05:27 -0800 (PST) Received: from kientzle.com (h-66-166-149-50.SNVACAID.covad.net [66.166.149.50]) by mx1.FreeBSD.org (Postfix) with ESMTP id E49A343D6A; Mon, 19 Jan 2004 13:05:14 -0800 (PST) (envelope-from kientzle@acm.org) Received: from acm.org ([66.166.149.54]) by kientzle.com (8.12.9/8.12.9) with ESMTP id i0JL56kX001425; Mon, 19 Jan 2004 13:05:14 -0800 (PST) (envelope-from kientzle@acm.org) Message-ID: <400C4681.8070709@acm.org> Date: Mon, 19 Jan 2004 13:05:05 -0800 From: Tim Kientzle User-Agent: Mozilla/5.0 (X11; U; FreeBSD i386; en-US; rv:1.4) Gecko/20031006 X-Accept-Language: en-us, en MIME-Version: 1.0 To: Ruslan Ermilov References: <200401190828.i0J8SUsY040770@repoman.freebsd.org> <20040119090934.GB2708@server.vk2pj.dyndns.org> <20040119092254.GA61125@VARK.homeunix.com> <20040119110415.GE41159@FreeBSD.org.ua> In-Reply-To: <20040119110415.GE41159@FreeBSD.org.ua> Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit cc: src-committers@FreeBSD.org cc: cvs-all@FreeBSD.org cc: cvs-src@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 Reply-To: kientzle@acm.org List-Id: CVS commit messages for the entire tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Jan 2004 21:05:27 -0000 Ruslan Ermilov wrote: > 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 >>>> 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. >> > > POSIX says "the decimal exponent of 2", and it sounds pretty > legal in mathematics, at least in this part of the world. ;) Yeah, I think das's wording should stand. (It seems slightly clearer than the POSIX wording.) Tim Kientzle (PhD Mathematics ;-)