From b9227c502d7f9023ef5fc44f67144a38d23339e4 Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Fri, 16 Dec 2022 20:46:00 +0200 Subject: [PATCH] ; Improve wording of 'format' doc string * src/editfns.c (Fformat): Use "produce" instead of "print". (Bug#60125) --- src/editfns.c | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/src/editfns.c b/src/editfns.c index b364f441b53..8d56ef21d90 100644 --- a/src/editfns.c +++ b/src/editfns.c @@ -3279,18 +3279,18 @@ The other arguments are substituted into it to make the result, a string. The format control string may contain %-sequences meaning to substitute the next available argument, or the argument explicitly specified: -%s means print a string argument. Actually, prints any object, with `princ'. -%d means print as signed number in decimal. -%o means print a number in octal. -%x means print a number in hex. +%s means produce a string argument. Actually, produces any object with `princ'. +%d means produce as signed number in decimal. +%o means produce a number in octal. +%x means produce a number in hex. %X is like %x, but uses upper case. -%e means print a number in exponential notation. -%f means print a number in decimal-point notation. -%g means print a number in exponential notation if the exponent would be +%e means produce a number in exponential notation. +%f means produce a number in decimal-point notation. +%g means produce a number in exponential notation if the exponent would be less than -4 or greater than or equal to the precision (default: 6); - otherwise it prints in decimal-point notation. -%c means print a number as a single character. -%S means print any object as an s-expression (using `prin1'). + otherwise it produces in decimal-point notation. +%c means produce a number as a single character. +%S means produce any object as an s-expression (using `prin1'). The argument used for %d, %o, %x, %e, %f, %g or %c must be a number. %o, %x, and %X treat arguments as unsigned if `binary-as-unsigned' is t @@ -3325,7 +3325,7 @@ included even if the precision is zero, and also forces trailing zeros after the decimal point to be left in place. The width specifier supplies a lower limit for the length of the -printed representation. The padding, if any, normally goes on the +produced 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 0 flag is ignored if the - flag is present, or the format sequence @@ -3334,7 +3334,7 @@ is something other than %d, %o, %x, %e, %f, and %g. For %e and %f sequences, the number after the "." in the precision specifier says how many decimal places to show; if zero, the decimal point itself is omitted. For %g, the precision specifies how many -significant digits to print; zero or omitted are treated as 1. +significant digits to produce; zero or omitted are treated as 1. For %s and %S, the precision specifier truncates the string to the given width. -- 2.39.2