GNU bug report logs - #24407
24.5; doc of `format'

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: tracker <at> debbugs.gnu.org
Subject: bug#24407: closed (24.5; doc of `format')
Date: Fri, 16 Sep 2016 09:59:01 +0000

[Message part 1 (text/plain, inline)]

Your message dated Fri, 16 Sep 2016 12:58:18 +0300
with message-id <8360pw5fph.fsf <at> gnu.org>
and subject line Re: bug#24407: 24.5; doc of `format'
has caused the debbugs.gnu.org bug report #24407,
regarding 24.5; doc of `format'
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs <at> gnu.org.)


-- 
24407: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=24407
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems

[Message part 2 (message/rfc822, inline)]

From: Drew Adams <drew.adams <at> oracle.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 24.5; doc of `format'
Date: Sat, 10 Sep 2016 15:20:25 -0700 (PDT)

The Elisp manual doc for `format' (node Formatting Strings) looks OK.
But the doc string has this bug:

  where flags is [+ #-0]+, width is [0-9]+, and precision is .[0-9]+

                                  must be a literal `.' here ^

The precision part should be this (or equivalent): "[.][0-9]+", not
".[0-9]+".


In GNU Emacs 24.5.1 (i686-pc-mingw32)
 of 2015-04-11 on LEG570
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --prefix=/c/usr --host=i686-pc-mingw32'

[Message part 3 (message/rfc822, inline)]

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 24407-done <at> debbugs.gnu.org
Subject: Re: bug#24407: 24.5; doc of `format'
Date: Fri, 16 Sep 2016 12:58:18 +0300

> Date: Sat, 10 Sep 2016 15:20:25 -0700 (PDT)
> From: Drew Adams <drew.adams <at> oracle.com>
> 
> The Elisp manual doc for `format' (node Formatting Strings) looks OK.
> But the doc string has this bug:
> 
>   where flags is [+ #-0]+, width is [0-9]+, and precision is .[0-9]+
> 
>                                   must be a literal `.' here ^

Yes, using a period in a regexp-like expression is confusing, when we
mean a literal period.

> The precision part should be this (or equivalent): "[.][0-9]+", not
> ".[0-9]+".

But this is not the best solution.  I opted for telling that precision
is a literal period followed by [0-9]+ instead.

Thanks, fixed on master.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.