diff options
| author | Alejandro Colomar <alx@kernel.org> | 2025-06-06 13:27:02 +0200 |
|---|---|---|
| committer | Alejandro Colomar <alx@kernel.org> | 2025-06-28 16:51:43 +0200 |
| commit | 8eea66b827a11bc8983da517499cc236c6cd97ba (patch) | |
| tree | aef545da6666369425609c27752453f9f9cf45d8 /man/man7 | |
| parent | 6569dd9b22d256f26928ddcc398db9f123546171 (diff) | |
| download | man-pages-master.tar.gz | |
Previously, many people confused these for actual parameters, since it's
hard to distinguish a ',' from ';'. By removing bold/italics from
these, it will be easier to distinguish them.
The cases have been found with a script:
$ find -type f \
| xargs grep -l '^\.TH ' \
| sort \
| xargs mansect SYNOPSIS \
| man /dev/stdin \
| grep -e '^[^ ]' -e '[^ ]( [^ )].*[^)];' \
| less;
Reported-by: Mark Naughton <mnaughto@redhat.com>
Suggested-by: Mark Harris <mark.hsj@gmail.com>
Acked-by: Mark Naughton <mnaughto@redhat.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Diffstat (limited to 'man/man7')
| -rw-r--r-- | man/man7/string_copying.7 | 16 |
1 files changed, 8 insertions, 8 deletions
diff --git a/man/man7/string_copying.7 b/man/man7/string_copying.7 index 39332d83b8..cfefde3054 100644 --- a/man/man7/string_copying.7 +++ b/man/man7/string_copying.7 @@ -30,15 +30,15 @@ strncat .BI "char *stpecpy(char *" dst ", char " end "[0], const char *restrict " src ); .P // Copy/catenate a string with truncation. -.BI "ssize_t strtcpy(size_t " dsize ; +.BR "ssize_t strtcpy(" "size_t dsize;" .BI " char " dst "[restrict " dsize "], \ const char *restrict " src , .BI " size_t " dsize ); -.BI "size_t strlcpy(size_t " dsize ; +.BR "size_t strlcpy(" "size_t dsize;" .BI " char " dst "[restrict " dsize "], \ const char *restrict " src , .BI " size_t " dsize ); -.BI "size_t strlcat(size_t " dsize ; +.BR "size_t strlcat(" "size_t dsize;" .BI " char " dst "[restrict " dsize "], \ const char *restrict " src , .BI " size_t " dsize ); @@ -48,11 +48,11 @@ const char *restrict " src , .nf // Fill a fixed-size buffer with characters from a string // and pad with null bytes. -.BI "char *strncpy(size_t " dsize ; +.BR "char *strncpy(" "size_t dsize;" .BI " char " dst "[restrict " dsize "], \ const char *restrict " src , .BI " size_t " dsize ); -.BI "char *stpncpy(size_t " dsize ; +.BR "char *stpncpy(" "size_t dsize;" .BI " char " dst "[restrict " dsize "], \ const char *restrict " src , .BI " size_t " dsize ); @@ -64,19 +64,19 @@ const char *restrict " src , .I stpcpy(mempcpy(dst, src, strnlen(src, NITEMS(src))), \[dq]\[dq]); .P // Catenate a null-padded character sequence into a string. -.BI "char *strncat(size_t " ssize ; +.BR "char *strncat(" "size_t ssize;" .BI " char *restrict " dst ", const char " src "[restrict " ssize ], .BI " size_t " ssize ); .P // Duplicate a null-padded character sequence into a string. -.BI "char *strndup(size_t " ssize ; +.BR "char *strndup(" "size_t ssize;" .BI " const char " src [ ssize "], size_t " ssize ); .fi .\" ----- SYNOPSIS :: Length-bounded character sequences --------------/ .SS Length-bounded character sequences .nf // Chain-copy a length-bounded character sequence. -.BI "void *mempcpy(size_t " len ; +.BR "void *mempcpy(" "size_t len;" .BI " void " dst "[restrict " len "], \ const void " src "[restrict " len ], .BI " size_t " len ); |