diff options
| author | Ken Pizzini <ken@gnu.org> | 2024-11-15 00:23:05 -0800 |
|---|---|---|
| committer | Alejandro Colomar <alx@kernel.org> | 2024-11-17 01:46:40 +0100 |
| commit | 2de7dcae651d41ca91790a2e64f527b89979c83e (patch) | |
| tree | 7f574965e395b32200ba19ec6cbdaad7d8f61b5d | |
| parent | 39764b24f79392bc2ff077564383cba4406c59b3 (diff) | |
| download | man-pages-2de7dcae651d41ca91790a2e64f527b89979c83e.tar.gz | |
printf.3: wfix
Improve terminology in %a description
The term "decimal point" does not technically apply when using bases
other than 10; the more generic term is "radix point". Update the
description of the a/A conversion specifier (i.e., for hexadecimal
floating point output) in printf(3) to use this terminology.
I do note that POSIX.1-2024 [1] does use the term "decimal-point
character" here, but I still maintain that using "radix point" is a
better term for that object in the %a description. (Confusingly, POSIX
does refer to "radix character" in the descriptions of %f and %e, where
reference to "decimal" instead of "radix" would actually make sense.)
Link: [1] <https://pubs.opengroup.org/onlinepubs/9799919799/functions/printf.html>
Signed-off-by: Ken Pizzini <ken@gnu.org>
Message-ID: <db91cc6f-93cc-4e99-806c-7a8b86232848@vagg4fs7.msa.explicate.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
| -rw-r--r-- | man/man3/printf.3 | 4 |
1 files changed, 2 insertions, 2 deletions
diff --git a/man/man3/printf.3 b/man/man3/printf.3 index 3bc731f6e5..7a96ec9c71 100644 --- a/man/man3/printf.3 +++ b/man/man3/printf.3 @@ -759,13 +759,13 @@ conversion the prefix the letters ABCDEF, and the exponent separator .B P is used. -There is one hexadecimal digit before the decimal point, +There is one hexadecimal digit before the radix point, and the number of digits after it is equal to the precision. The default precision suffices for an exact representation of the value if an exact representation in base 2 exists and otherwise is sufficiently large to distinguish values of type .IR double . -The digit before the decimal point is unspecified for nonnormalized +The digit before the radix point is unspecified for nonnormalized numbers, and nonzero but otherwise unspecified for normalized numbers. The exponent always contains at least one digit; if the value is zero, the exponent is 0. |