]> git.ipfire.org Git - thirdparty/man-pages.git/commitdiff
printf.3: wfix
authorKen Pizzini <ken@gnu.org>
Fri, 15 Nov 2024 08:23:05 +0000 (00:23 -0800)
committerAlejandro Colomar <alx@kernel.org>
Sun, 17 Nov 2024 00:46:40 +0000 (01:46 +0100)
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>
man/man3/printf.3

index 3bc731f6e5c8ba737cbabfc4e8e9c2671043bd34..7a96ec9c71b9b406362b46d4e540d52c73526ae7 100644 (file)
@@ -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.