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

Package: emacs;

Reported by: Drew Adams <drew.adams <at> oracle.com>

Date: Sat, 10 Sep 2016 22:21:01 UTC

Severity: minor

Found in version 24.5

Done: Eli Zaretskii <eliz <at> gnu.org>

Bug is archived. No further changes may be made.

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 24407 in the body.
You can then email your comments to 24407 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

View this report as an mbox folder, status mbox, maintainer mbox

Report forwarded to bug-gnu-emacs <at> gnu.org:
bug#24407; Package emacs. (Sat, 10 Sep 2016 22:21:02 GMT) Full text and rfc822 format available.

Acknowledgement sent to Drew Adams <drew.adams <at> oracle.com>:
New bug report received and forwarded. Copy sent to bug-gnu-emacs <at> gnu.org. (Sat, 10 Sep 2016 22:21:02 GMT) Full text and rfc822 format available.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

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'

Reply sent to Eli Zaretskii <eliz <at> gnu.org>:
You have taken responsibility. (Fri, 16 Sep 2016 09:59:01 GMT) Full text and rfc822 format available.

Notification sent to Drew Adams <drew.adams <at> oracle.com>:
bug acknowledged by developer. (Fri, 16 Sep 2016 09:59:02 GMT) Full text and rfc822 format available.

Message #10 received at 24407-done <at> debbugs.gnu.org (full text, mbox):

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.

bug archived. Request was from Debbugs Internal Request <help-debbugs <at> gnu.org> to internal_control <at> debbugs.gnu.org. (Fri, 14 Oct 2016 11:24:03 GMT) Full text and rfc822 format available.

This bug report was last modified 8 years and 254 days ago.

Previous Next

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

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

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