From: Paul Pluzhnikov <ppluzhnikov@google.com>
To: Siddhesh Poyarekar <siddhesh@gotplt.org>
Cc: GLIBC Devel <libc-alpha@sourceware.org>
Subject: Re: [patch] Document '%F' format specifier
Date: Tue, 24 Jan 2023 09:49:50 -0800 [thread overview]
Message-ID: <CALoOobPi+MT2n8XYF_nmS1bCtXX55=GXsYujLuEB_wa=PipcXA@mail.gmail.com> (raw)
In-Reply-To: <129eebb5-6a60-5ab1-9e95-6c35b61111cc@gotplt.org>
[-- Attachment #1: Type: text/plain, Size: 687 bytes --]
On Mon, Jan 23, 2023 at 8:42 AM Siddhesh Poyarekar <siddhesh@gotplt.org> wrote:
>
> On 2023-01-18 21:43, Paul Pluzhnikov via Libc-alpha wrote:
> > The '%F' specifier was implemented in commit 6c46718f9f0 on
> > 2000-08-23, but remains undocumented in the manual.
> > https://stackoverflow.com/questions/75157669/format-specifier-f-missing-from-glibcs-documentation
> >
> > Fix that.
> >
>
> The patch fails to apply on master.
Sorry about that -- I've attached a revised patch.
> Please also review other sections in stdio.texi that mention %f and add
> %F wherever applicable, e.g. input conversions.
I think I got all the instances of '%f' updated now.
Thanks,
--
Paul Pluzhnikov
[-- Attachment #2: glibc-manual-stdio-20230124.txt --]
[-- Type: text/plain, Size: 4024 bytes --]
diff --git a/manual/stdio.texi b/manual/stdio.texi
index f6319a4b8a..2aba957873 100644
--- a/manual/stdio.texi
+++ b/manual/stdio.texi
@@ -1845,8 +1845,9 @@ Print an integer as an unsigned hexadecimal number. @samp{%x} uses
lower-case letters and @samp{%X} uses upper-case. @xref{Integer
Conversions}, for details.
-@item @samp{%f}
+@item @samp{%f}, @samp{%F}
Print a floating-point number in normal (fixed-point) notation.
+@samp{%f} uses lower-case letters and @samp{%F} uses upper-case.
@xref{Floating-Point Conversions}, for details.
@item @samp{%e}, @samp{%E}
@@ -2073,11 +2074,11 @@ various format options, using the template string:
@subsection Floating-Point Conversions
This section discusses the conversion specifications for floating-point
-numbers: the @samp{%f}, @samp{%e}, @samp{%E}, @samp{%g}, and @samp{%G}
-conversions.
+numbers: the @samp{%f}, @samp{%F}, @samp{%e}, @samp{%E}, @samp{%g}, and
+@samp{%G} conversions.
-The @samp{%f} conversion prints its argument in fixed-point notation,
-producing output of the form
+The @samp{%f} and @samp{%F} conversions print their argument in fixed-point
+notation, producing output of the form
@w{[@code{-}]@var{ddd}@code{.}@var{ddd}},
where the number of digits following the decimal point is controlled
by the precision you specify.
@@ -2093,7 +2094,7 @@ the precision. The exponent always contains at least two digits. The
The @samp{%g} and @samp{%G} conversions print the argument in the style
of @samp{%e} or @samp{%E} (respectively) if the exponent would be less
than -4 or greater than or equal to the precision; otherwise they use
-the @samp{%f} style. A precision of @code{0}, is taken as 1.
+the @samp{%f} of @same{%F} style. A precision of @code{0}, is taken as 1.
Trailing zeros are removed from the fractional portion of the result and
a decimal-point character appears only if it is followed by a digit.
@@ -2123,7 +2124,7 @@ If the value to be printed represents infinity or a NaN, the output is
@w{[@code{-}]@code{inf}} or @code{nan} respectively if the conversion
specifier is @samp{%a}, @samp{%e}, @samp{%f}, or @samp{%g} and it is
@w{[@code{-}]@code{INF}} or @code{NAN} respectively if the conversion is
-@samp{%A}, @samp{%E}, or @samp{%G}. On some implementations, a NaN
+@samp{%A}, @samp{%E}, @samp{%F} or @samp{%G}. On some implementations, a NaN
may result in longer output with information about the payload of the
NaN; ISO C2X defines a macro @code{_PRINTF_NAN_LEN_MAX} giving the
maximum length of such output.
@@ -2162,8 +2163,8 @@ specified.
@end table
The precision specifies how many digits follow the decimal-point
-character for the @samp{%f}, @samp{%e}, and @samp{%E} conversions. For
-these conversions, the default precision is @code{6}. If the precision
+character for the @samp{%f}, @samp{%F}, @samp{%e}, and @samp{%E} conversions.
+For these conversions, the default precision is @code{6}. If the precision
is explicitly @code{0}, this suppresses the decimal point character
entirely. For the @samp{%g} and @samp{%G} conversions, the precision
specifies how many significant digits to print. Significant digits are
@@ -3535,7 +3536,7 @@ Matches an unsigned integer written in decimal radix.
Matches an unsigned integer written in hexadecimal radix.
@xref{Numeric Input Conversions}.
-@item @samp{%e}, @samp{%f}, @samp{%g}, @samp{%E}, @samp{%G}
+@item @samp{%e}, @samp{%f}, @samp{%g}, @samp{%E}, @samp{%F}, @samp{%G}
Matches an optionally signed floating-point number. @xref{Numeric Input
Conversions}.
@@ -3691,7 +3692,7 @@ Specifies that the argument is a @code{size_t *}.
This modifier was introduced in @w{ISO C99}.
@end table
-All of the @samp{%e}, @samp{%f}, @samp{%g}, @samp{%E}, and @samp{%G}
+All of the @samp{%e}, @samp{%f}, @samp{%g}, @samp{%E}, @samp{%F} and @samp{%G}
input conversions are interchangeable. They all match an optionally
signed floating point number, in the same syntax as for the
@code{strtod} function (@pxref{Parsing of Floats}).
next prev parent reply other threads:[~2023-01-24 17:50 UTC|newest]
Thread overview: 6+ messages / expand[flat|nested] mbox.gz Atom feed top
2023-01-19 2:43 Paul Pluzhnikov
2023-01-23 16:42 ` Siddhesh Poyarekar
2023-01-24 17:49 ` Paul Pluzhnikov [this message]
2023-01-24 21:32 ` Siddhesh Poyarekar
2023-01-24 22:20 ` Paul Pluzhnikov
2023-01-24 23:31 ` Siddhesh Poyarekar
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to='CALoOobPi+MT2n8XYF_nmS1bCtXX55=GXsYujLuEB_wa=PipcXA@mail.gmail.com' \
--to=ppluzhnikov@google.com \
--cc=libc-alpha@sourceware.org \
--cc=siddhesh@gotplt.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).