procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Clarify what the "-" and "0" flags mean in the `format' function

Browse source 
(bug#6659).
This commit is contained in:
Lars Magne Ingebrigtsen 2011-07-03 15:02:43 +02:00
parent 79414ae4df
commit a9ab721e7f
4 changed files with 17 additions and 7 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

3
doc/lispref/ChangeLog
View file

@ -1,5 +1,8 @@
2011-07-03 Lars Magne Ingebrigtsen <larsi@gnus.org>
* strings.texi (Formatting Strings): Clarify what the "-" and "0"
flags mean (bug#6659).
* functions.texi (What Is a Function): Document the autoload
object (bug#6496).

14
doc/lispref/strings.texi
View file

@ -856,14 +856,16 @@ with @samp{0x} or @samp{0X}. For @samp{%e}, @samp{%f}, and @samp{%g},
the @samp{#} flag means include a decimal point even if the precision
is zero.
The flag @samp{0} ensures that the padding consists of @samp{0}
characters instead of spaces. This flag is ignored for non-numerical
specification characters like @samp{%s}, @samp{%S} and @samp{%c}.
These specification characters accept the @samp{0} flag, but still pad
with @emph{spaces}.
The flag @samp{-} causes the padding inserted by the width
specifier, if any, to be inserted on the right rather than the left.
The flag @samp{0} ensures that the padding consists of @samp{0}
characters instead of spaces, inserted on the left. These flags are
ignored for specification characters for which they do not make sense:
@samp{%s}, @samp{%S} and @samp{%c} accept the @samp{0} flag, but still
pad with @emph{spaces} on the left. If both @samp{-} and @samp{0} are
present and valid, @samp{-} takes precedence.
If both @samp{-} and @samp{0} are present, the @samp{0} flag is
ignored.
@example
@group

4
src/ChangeLog
View file

@ -1,3 +1,7 @@
2011-07-03 Lars Magne Ingebrigtsen <larsi@gnus.org>
* editfns.c (Fformat): Clarify the - and 0 flags (bug#6659).
2011-07-03 Paul Eggert <eggert@cs.ucla.edu>
* xsettings.c (SYSTEM_FONT): Define only when used.

3
src/editfns.c
View file

@ -3557,7 +3557,8 @@ The width specifier supplies a lower limit for the length of the
printed representation. The padding, if any, normally goes on the
left, but it goes on the right if the - flag is present. The padding
character is normally a space, but it is 0 if the 0 flag is present.
The - flag takes precedence over the 0 flag.
The 0 flag is ignored if the - flag is present, or the format sequence
is something other than %d, %e, %f, and %g.
For %e, %f, and %g sequences, the number after the "." in the
precision specifier says how many decimal places to show; if zero, the