man3/*: srcfix: remove superfluous quotes around space-free arguments
PATCH 1/1 man3/*: srcfix: remove superfluous quotes around space-free arguments
Remove quotes around a space-free argument for the single-font macros.
Fix a font issue in "strfmon.3".
--- man3/getline.3 | 14 +++++++------- man3/isalpha.3 | 2 +- man3/posix_memalign.3 | 2 +- man3/realpath.3 | 4 ++-- man3/setlocale.3 | 2 +- man3/strcoll.3 | 4 ++-- man3/strfmon.3 | 4 ++-- 7 files changed, 16 insertions(+), 16 deletions(-)
man3/getline.3 +7 -7
@@ -64,7 +64,7 @@ The buffer is null-terminated and includes the newline character, if one was found. .PP If -.I "*lineptr" +.I *lineptr is set to NULL and .I *n is set 0 before the call, then
@@ -77,26 +77,26 @@ failed. .PP Alternatively, before calling .BR getline (), -.I "*lineptr" +.I *lineptr can contain a pointer to a .BR malloc (3)\-allocated buffer -.I "*n" +.I *n bytes in size. If the buffer is not large enough to hold the line, .BR getline () resizes it with .BR realloc (3), updating -.I "*lineptr" +.I *lineptr and -.I "*n" +.I *n as necessary. .PP In either case, on a successful call, -.I "*lineptr" +.I *lineptr and -.I "*n" +.I *n will be updated to reflect the buffer address and allocated size respectively. .PP .BR getdelim ()
man3/isalpha.3 +1 -1
@@ -349,7 +349,7 @@ locale. For example, .BR isupper () will not recognize an A-umlaut (\(:A) as an uppercase letter in the default -.B "C" +.B C locale. .SH SEE ALSO .BR iswalnum (3),
man3/posix_memalign.3 +1 -1
@@ -251,7 +251,7 @@ if suitable feature test macros are defined (see above). On many systems there are alignment restrictions, for example, on buffers used for direct block device I/O. POSIX specifies the -.I "pathconf(path,_PC_REC_XFER_ALIGN)" +.I pathconf(path,_PC_REC_XFER_ALIGN) call that tells what alignment is needed. Now one can use .BR posix_memalign ()
man3/realpath.3 +2 -2
@@ -66,9 +66,9 @@ bytes, in the buffer pointed to by .IR resolved_path . The resulting path will have no symbolic link, -.I "/./" +.I /./ or -.I "/../" +.I /../ components. .PP If
man3/setlocale.3 +1 -1
@@ -129,7 +129,7 @@ is an ISO 639 language code, is an ISO 3166 country code, and .I codeset is a character set or encoding identifier like -.B "ISO-8859-1" +.B ISO-8859-1 or .BR "UTF-8" . For a list of all supported locales, try "locale \-a" (see
man3/strcoll.3 +2 -2
@@ -83,9 +83,9 @@ T} Thread safety MT-Safe locale POSIX.1-2001, POSIX.1-2008, C89, C99, SVr4, 4.3BSD. .SH NOTES In the -.I "POSIX" +.I POSIX or -.I "C" +.I C locales .BR strcoll () is equivalent to
man3/strfmon.3 +2 -2
@@ -29,10 +29,10 @@ strfmon, strfmon_l \- convert monetary value to a string .B #include <monetary.h> .PP .BI "ssize_t strfmon(char *" s ", size_t " max ", const char *" format , -.B "...);" +.IB ... ); .PP .BI "ssize_t strfmon_l(char *" s ", size_t " max ", locale_t " locale , -.B const char *" format , "...);" +.BI "const char *" format , ... ); .fi .SH DESCRIPTION The
Signature · 1 line
2.27.0
THe strfmon(3) change is unrelated to the other changes, and should have been in a separate patch.
* Bjarni Ingi Gislason <[email protected]>, 2020-07-05, 13:40:
Quoted 8 lines
man3/strfmon.3 +0
-0@@ -29,10 +29,10 @@ strfmon, strfmon_l \- convert monetary value to a string.B #include <
monetary.h>
.PP
.BI "ssize_tstrfmon(char *" s ", size_t " max ", const char *" format , -.B "...);"
+.IB ... );
For variadic function the convention seems to be to format "..." in bold; see scanf(3), printf(3), wprintf(3) and execv(3) man pages. This makes sense, because unlike argument names, "..." appear literally in the function prototypes.
Quoted 2 lines
-.B const char *" format , "...);"
+.BI "const char *" format , ... );
Ditto. So this line should be:
.BI "const char *" format ", ...);"
Signature · 1 line
Jakub Wilk
Quoted 2 lines · Jakub Wilk
THe strfmon(3) change is unrelated to the other changes, and should have been in a separate patch.
Exactly.
Bjarni, it's bets if you don't mix unrelated changes tinto the same patch.
Thanks,
Michael
Quoted 22 lines
* Bjarni Ingi Gislason <[email protected]>, 2020-07-05, 13:40:
Quoted 8 lines
man3/strfmon.3 +0
-0@@ -29,10 +29,10 @@ strfmon, strfmon_l \- convert monetary value to a string.B #include <
monetary.h>
.PP
.BI "ssize_tstrfmon(char *" s ", size_t " max ", const char *" format , -.B "...);"
+.IB ... );For variadic function the convention seems to be to format "..." in bold; see scanf(3), printf(3), wprintf(3) and execv(3) man pages. This makes sense, because unlike argument names, "..." appear literally in the function prototypes.
Quoted 2 lines
-.B const char *" format , "...);"
+.BI "const char *" format , ... );Ditto. So this line should be:
.BI "const char *" format ", ...);"
Signature · 3 lines
Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/
Quoted 18 lines · Jakub Wilk
THe strfmon(3) change is unrelated to the other changes, and should have been in a separate patch.
* Bjarni Ingi Gislason <[email protected]>, 2020-07-05, 13:40:
Quoted 8 lines
man3/strfmon.3 +0
-0@@ -29,10 +29,10 @@ strfmon, strfmon_l \- convert monetary value to a string.B #include <
monetary.h>
.PP
.BI "ssize_tstrfmon(char *" s ", size_t " max ", const char *" format , -.B "...);"
+.IB ... );For variadic function the convention seems to be to format "..." in bold; see scanf(3), printf(3), wprintf(3) and execv(3) man pages. This makes sense, because unlike argument names, "..." appear literally in the function prototypes.
Quoted 6 lines
Quoted 2 lines
-.B const char *" format , "...);"
+.BI "const char *" format , ... );Ditto. So this line should be:
.BI "const char *" format ", ...);"
Thanks, Jakub. Fixed.
Cheers,
Michael
Signature · 3 lines
Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/