From: Alejandro Colomar Date: Sat, 23 Aug 2025 19:40:10 +0000 (+0200) Subject: man/: Address diagnostic about mismatched quotes X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=17fa7e849eb524eeda51beadc9924527358722bb;p=thirdparty%2Fman-pages.git man/: Address diagnostic about mismatched quotes Most of these are false positives, in the sense that a line break is escaped, and the matching quote is in the next source line. However, let's remove those escaped line breaks, which make reading the source more difficult. For this, rename some parameters to be shorter, and allow some lines to go slightly past the 80-column right margin. Signed-off-by: Alejandro Colomar --- diff --git a/man/man2/alloc_hugepages.2 b/man/man2/alloc_hugepages.2 index 05619bcb7..d87d2e8b6 100644 --- a/man/man2/alloc_hugepages.2 +++ b/man/man2/alloc_hugepages.2 @@ -8,8 +8,8 @@ alloc_hugepages, free_hugepages \- allocate or free huge pages .SH SYNOPSIS .nf .BR "void *syscall(" "size_t size;" -.BI " SYS_alloc_hugepages, int " key ", void " addr [ size "], \ -size_t " size , +.BI " SYS_alloc_hugepages, int " key , +.BI " void " addr [ size "], size_t " size , .BI " int " prot ", int " flag ); .\" asmlinkage unsigned long sys_alloc_hugepages(int key, unsigned long addr, .\" unsigned long size, int prot, int flag); diff --git a/man/man2/epoll_wait.2 b/man/man2/epoll_wait.2 index 3d0fbc986..b81d88a85 100644 --- a/man/man2/epoll_wait.2 +++ b/man/man2/epoll_wait.2 @@ -13,17 +13,16 @@ Standard C library .nf .B #include .P -.BR "int epoll_wait(" "int maxevents;" -.BI " int " epfd ", struct epoll_event " events [ maxevents ], -.BI " int " maxevents ", int " timeout ); -.BR "int epoll_pwait(" "int maxevents;" -.BI " int " epfd ", struct epoll_event " events [ maxevents ], -.BI " int " maxevents ", int " timeout , +.BR "int epoll_wait(" "int n;" +.BI " int " epfd ", struct epoll_event " events [ n "], int " n , +.BI " int " timeout ); +.BR "int epoll_pwait(" "int n;" +.BI " int " epfd ", struct epoll_event " events [ n "], int " n , +.BI " int " timeout , .BI " const sigset_t *_Nullable " sigmask ); -.BR "int epoll_pwait2(" "int maxevents;" -.BI " int " epfd ", struct epoll_event " events [ maxevents ], -.BI " int " maxevents ", \ -const struct timespec *_Nullable " timeout , +.BR "int epoll_pwait2(" "int n;" +.BI " int " epfd ", struct epoll_event " events [ n "], int " n , +.BI " const struct timespec *_Nullable " timeout , .BI " const sigset_t *_Nullable " sigmask ); .fi .SH DESCRIPTION @@ -39,11 +38,11 @@ is used to return information from the ready list about file descriptors in the interest list that have some events available. Up to -.I maxevents +.I n are returned by .BR epoll_wait (). The -.I maxevents +.I n argument must be greater than zero. .P The @@ -124,7 +123,7 @@ call: .P .in +4n .EX -ready = epoll_pwait(epfd, &events, maxevents, timeout, &sigmask); +ready = epoll_pwait(epfd, &events, n, timeout, &sigmask); .EE .in .P @@ -137,7 +136,7 @@ executing the following calls: sigset_t origmask; \& pthread_sigmask(SIG_SETMASK, &sigmask, &origmask); -ready = epoll_wait(epfd, &events, maxevents, timeout); +ready = epoll_wait(epfd, &events, n, timeout); pthread_sigmask(SIG_SETMASK, &origmask, NULL); .EE .in @@ -204,7 +203,7 @@ expired; see is not an .B epoll file descriptor, or -.I maxevents +.I n is less than or equal to zero. .SH STANDARDS Linux. @@ -234,7 +233,7 @@ it will cause the call to unblock. .P If more than -.I maxevents +.I n file descriptors are ready when .BR epoll_wait () is called, then successive diff --git a/man/man2/getcpu.2 b/man/man2/getcpu.2 index f4ba11bd5..8236e671e 100644 --- a/man/man2/getcpu.2 +++ b/man/man2/getcpu.2 @@ -13,8 +13,7 @@ Standard C library .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" .B #include .P -.BI "int getcpu(unsigned int *_Nullable " cpu ", \ -unsigned int *_Nullable " node ); +.BI "int getcpu(unsigned int *_Nullable " cpu ", unsigned int *_Nullable " node ); .fi .SH DESCRIPTION The diff --git a/man/man2/getrandom.2 b/man/man2/getrandom.2 index 9e4f03c48..141eb94d1 100644 --- a/man/man2/getrandom.2 +++ b/man/man2/getrandom.2 @@ -12,9 +12,8 @@ Standard C library .nf .B #include .P -.BR "ssize_t getrandom(" "size_t buflen;" -.BI " void " buf [ buflen "], size_t " buflen ", \ -unsigned int " flags ); +.BR "ssize_t getrandom(" "size_t size;" +.BI " void " buf [ size "], size_t " size ", unsigned int " flags ); .fi .SH DESCRIPTION The @@ -22,7 +21,7 @@ The system call fills the buffer pointed to by .I buf with up to -.I buflen +.I size random bytes. These bytes can be used to seed user-space random number generators or for cryptographic purposes. @@ -79,7 +78,7 @@ noise. If the number of available bytes in the .I random source is less than requested in -.IR buflen , +.IR size , the call returns just the available random bytes. If no random bytes are available, the behavior depends on the presence of .B GRND_NONBLOCK @@ -110,7 +109,7 @@ On success, returns the number of bytes that were copied to the buffer .IR buf . This may be less than the number of bytes requested via -.I buflen +.I size if either .B GRND_RANDOM was specified in @@ -229,18 +228,18 @@ that is blocked while reading from the source is interrupted by a signal handler depends on the initialization state of the entropy buffer and on the request size, -.IR buflen . +.IR size . If the entropy is not yet initialized, then the call fails with the .B EINTR error. If the entropy pool has been initialized and the request size is large -.RI ( buflen "\ >\ 256)," +.RI ( size "\ >\ 256)," the call either succeeds, returning a partially filled buffer, or fails with the error .BR EINTR . If the entropy pool has been initialized and the request size is small -.RI ( buflen "\ <=\ 256)," +.RI ( size "\ <=\ 256)," then .BR getrandom () will not fail with @@ -260,7 +259,7 @@ to read small buffers (<=\ 256 bytes) from the source is the preferred mode of usage. .P The special treatment of small values of -.I buflen +.I size was designed for compatibility with OpenBSD's .BR getentropy (3), @@ -275,7 +274,7 @@ or fewer bytes than requested were returned. In the case where .B GRND_RANDOM is not specified and -.I buflen +.I size is less than or equal to 256, a return of fewer bytes than requested should never happen, but the careful programmer will check for this anyway! diff --git a/man/man2/init_module.2 b/man/man2/init_module.2 index 9ef4d5875..45b4d2a6f 100644 --- a/man/man2/init_module.2 +++ b/man/man2/init_module.2 @@ -16,8 +16,8 @@ Standard C library .B #include .P .BR "int syscall(" "unsigned long size;" -.BI " SYS_init_module, void " module_image [ size "], \ -unsigned long " size , +.B " SYS_init_module," +.BI " void " module_image [ size "], unsigned long " size , .BI " const char *" param_values ); .BI "int syscall(SYS_finit_module, int " fd , .BI " const char *" param_values ", int " flags ); diff --git a/man/man2/mlock.2 b/man/man2/mlock.2 index 9bf711140..6a0397f50 100644 --- a/man/man2/mlock.2 +++ b/man/man2/mlock.2 @@ -15,8 +15,7 @@ Standard C library .BR "int mlock(" "size_t size;" .BI " const void " addr [ size "], size_t " size ); .BR "int mlock2(" "size_t size;" -.BI " const void " addr [ size "], size_t " size ", \ -unsigned int " flags ); +.BI " const void " addr [ size "], size_t " size ", unsigned int " flags ); .BR "int munlock(" "size_t size;" .BI " const void " addr [ size "], size_t " size ); .P diff --git a/man/man2/move_pages.2 b/man/man2/move_pages.2 index 55b851993..f678032e3 100644 --- a/man/man2/move_pages.2 +++ b/man/man2/move_pages.2 @@ -17,10 +17,9 @@ NUMA (Non-Uniform Memory Access) policy library .nf .B #include .P -.BI "long move_pages(int " pid ", unsigned long " count ", \ -void *" pages [ count ], -.BI " const int " nodes [ count "], int " status [ count "], \ -int " flags ); +.BI "long move_pages(int " pid ", unsigned long " count ", void *" pages [ count ], +.BI " const int " nodes [ count "], int " status [ count ], +.BI " int " flags ); .fi .SH DESCRIPTION .BR move_pages () diff --git a/man/man2/query_module.2 b/man/man2/query_module.2 index 9595a5a17..396e16897 100644 --- a/man/man2/query_module.2 +++ b/man/man2/query_module.2 @@ -12,8 +12,7 @@ query_module \- query the kernel for various bits pertaining to modules .P .BR "[[deprecated]] int query_module(" "size_t bufsize;" .BI " const char *" name ", int " which , -.BI " void " buf [ bufsize "], \ -size_t " bufsize , +.BI " void " buf [ bufsize "], size_t " bufsize , .BI " size_t *" ret ); .fi .SH DESCRIPTION diff --git a/man/man2/remap_file_pages.2 b/man/man2/remap_file_pages.2 index 9c3059f44..823fb73cf 100644 --- a/man/man2/remap_file_pages.2 +++ b/man/man2/remap_file_pages.2 @@ -15,8 +15,7 @@ Standard C library .P .BR "[[deprecated]] int remap_file_pages(" "size_t size;" .BI " void " addr [ size "], size_t " size , -.BI " int " prot ", size_t " pgoff ", \ -int " flags ); +.BI " int " prot ", size_t " pgoff ", int " flags ); .fi .SH DESCRIPTION .BR Note : diff --git a/man/man2/sendfile.2 b/man/man2/sendfile.2 index 837699b5b..3c2a5896d 100644 --- a/man/man2/sendfile.2 +++ b/man/man2/sendfile.2 @@ -12,9 +12,8 @@ Standard C library .nf .B #include .P -.BI "ssize_t sendfile(int" " out_fd" ", int" " in_fd" ", \ -off_t *_Nullable " offset , -.BI " size_t" " count" ); +.BI "ssize_t sendfile(int" " out_fd" ", int" " in_fd" ", off_t *_Nullable " offset , +.BI " size_t " count ); .\" The below is too ugly. Comments about glibc versions belong .\" in the notes, not in the header. .\" diff --git a/man/man2/shmop.2 b/man/man2/shmop.2 index 660d9615e..bdabd6dce 100644 --- a/man/man2/shmop.2 +++ b/man/man2/shmop.2 @@ -12,8 +12,7 @@ Standard C library .nf .B #include .P -.BI "void *shmat(int " shmid ", const void *_Nullable " shmaddr ", \ -int " shmflg ); +.BI "void *shmat(int " shmid ", const void *_Nullable " shmaddr ", int " shmflg ); .BI "int shmdt(const void *" shmaddr ); .fi .SH DESCRIPTION diff --git a/man/man3/bcmp.3 b/man/man3/bcmp.3 index 153c2f141..acb965ab9 100644 --- a/man/man3/bcmp.3 +++ b/man/man3/bcmp.3 @@ -13,8 +13,7 @@ Standard C library .B #include .P .BR "[[deprecated]] int bcmp(" "size_t n;" -.BI " const void " s1 [ n "], const void " s2 [ n "], \ -size_t " n ); +.BI " const void " s1 [ n "], const void " s2 [ n "], size_t " n ); .fi .SH DESCRIPTION .BR bcmp () diff --git a/man/man3/bcopy.3 b/man/man3/bcopy.3 index 9f234c761..50804d4d3 100644 --- a/man/man3/bcopy.3 +++ b/man/man3/bcopy.3 @@ -14,8 +14,7 @@ Standard C library .B #include .P .BR "[[deprecated]] void bcopy(" "size_t n;" -.BI " const void " src [ n "], void " dest [ n "], \ -size_t " n ); +.BI " const void " src [ n "], void " dest [ n "], size_t " n ); .fi .SH DESCRIPTION The diff --git a/man/man3/cfree.3 b/man/man3/cfree.3 index dfa2b5a13..98e2050c9 100644 --- a/man/man3/cfree.3 +++ b/man/man3/cfree.3 @@ -22,8 +22,7 @@ Standard C library .P /* In SCO OpenServer */ .BR "void cfree(" "unsigned int n, unsigned int size;" -.BI " char " ptr [ size " * " n "], unsigned int " n ", \ -unsigned int " size ); +.BI " char " ptr [ size " * " n "], unsigned int " n ", unsigned int " size ); .P /* In Solaris watchmalloc.so.1 */ .BR "void cfree(" "size_t n, size_t size;" diff --git a/man/man3/fgetc.3 b/man/man3/fgetc.3 index b2c5b37eb..6ee0dd853 100644 --- a/man/man3/fgetc.3 +++ b/man/man3/fgetc.3 @@ -18,8 +18,7 @@ Standard C library .B "int getchar(void);" .P .BR "char *fgets(" "int size;" -.BI " char " s "[restrict " size "], int " size ", \ -FILE *restrict " stream ); +.BI " char " s "[restrict " size "], int " size ", FILE *restrict " stream ); .P .BI "int ungetc(int " c ", FILE *" stream ); .fi diff --git a/man/man3/getdirentries.3 b/man/man3/getdirentries.3 index 255297feb..e96eb2fc6 100644 --- a/man/man3/getdirentries.3 +++ b/man/man3/getdirentries.3 @@ -14,9 +14,8 @@ Standard C library .nf .B #include .P -.BR "ssize_t getdirentries(" "size_t nbytes;" -.BI " int " fd ", char " buf "[restrict " nbytes "], \ -size_t " nbytes , +.BR "ssize_t getdirentries(" "size_t size;" +.BI " int " fd ", char " buf "[restrict " size "], size_t " size , .BI " off_t *restrict " basep ); .fi .P @@ -38,8 +37,8 @@ Read directory entries from the directory specified by into .IR buf . At most -.I nbytes -are read. +.I size +bytes are read. Reading starts at offset .IR *basep , and diff --git a/man/man3/getpwnam.3 b/man/man3/getpwnam.3 index f02b028af..7fce2e7ce 100644 --- a/man/man3/getpwnam.3 +++ b/man/man3/getpwnam.3 @@ -18,12 +18,13 @@ Standard C library .BI "struct passwd *getpwuid(uid_t " uid ); .P .BR "int getpwnam_r(" "size_t size;" -.BI " const char *restrict " name ", \ -struct passwd *restrict " pwd , +.BI " const char *restrict " name , +.BI " struct passwd *restrict " pwd , .BI " char " buf "[restrict " size "], size_t " size , .BI " struct passwd **restrict " result ); .BR "int getpwuid_r(" "size_t size;" -.BI " uid_t " uid ", struct passwd *restrict " pwd , +.BI " uid_t " uid , +.BI " struct passwd *restrict " pwd , .BI " char " buf "[restrict " size "], size_t " size , .BI " struct passwd **restrict " result ); .fi diff --git a/man/man3/getspnam.3 b/man/man3/getspnam.3 index f49d87727..14146d9d7 100644 --- a/man/man3/getspnam.3 +++ b/man/man3/getspnam.3 @@ -35,21 +35,21 @@ Standard C library .P .BR "int getspent_r(" "size_t size;" .BI " struct spwd *" spbuf , -.BI " char " buf [ size "], size_t " size ", \ -struct spwd **" spbufp ); +.BI " char " buf [ size "], size_t " size , +.BI " struct spwd **" spbufp ); .BR "int getspnam_r(" "size_t size;" .BI " const char *" name ", struct spwd *" spbuf , -.BI " char " buf [ size "], size_t " size ", \ -struct spwd **" spbufp ); +.BI " char " buf [ size "], size_t " size , +.BI " struct spwd **" spbufp ); .P .BR "int fgetspent_r(" "size_t size;" .BI " FILE *" stream ", struct spwd *" spbuf , -.BI " char " buf [ size "], size_t " size ", \ -struct spwd **" spbufp ); +.BI " char " buf [ size "], size_t " size , +.BI " struct spwd **" spbufp ); .BR "int sgetspent_r(" "size_t size;" .BI " const char *" s ", struct spwd *" spbuf , -.BI " char " buf [ size "], size_t " size ", \ -struct spwd **" spbufp ); +.BI " char " buf [ size "], size_t " size , +.BI " struct spwd **" spbufp ); .fi .P .RS -4 diff --git a/man/man3/lsearch.3 b/man/man3/lsearch.3 index 8576ab86b..fd923c89a 100644 --- a/man/man3/lsearch.3 +++ b/man/man3/lsearch.3 @@ -14,14 +14,14 @@ Standard C library .B #include .P .BR "void *lfind(" "size_t *n, size_t size;" -.BI " const void " key [ size "], \ -const void " base [* n " * " size ], +.BI " const void " key [ size ], +.BI " const void " base [* n " * " size ], .BI " size_t *" n ", size_t " size , .BI " typeof(int (const void [" size "], const void [" size ])) .BI " *" compar ); .BR "void *lsearch(" "size_t *n, size_t size;" -.BI " const void " key [ size "], \ -void " base [* n " * " size ], +.BI " const void " key [ size ], +.BI " void " base [* n " * " size ], .BI " size_t *" n ", size_t " size , .BI " typeof(int (const void [" size "], const void [" size ])) .BI " *" compar ); diff --git a/man/man3/mbstowcs.3 b/man/man3/mbstowcs.3 index 655af0d97..1637f127e 100644 --- a/man/man3/mbstowcs.3 +++ b/man/man3/mbstowcs.3 @@ -14,8 +14,7 @@ Standard C library .B #include .P .BR "size_t mbstowcs(" "size_t dsize;" -.BI " wchar_t " dest "[restrict " dsize "], \ -const char *restrict " src , +.BI " wchar_t " dest "[restrict " dsize "], const char *restrict " src , .BI " size_t " dsize ); .fi .SH DESCRIPTION diff --git a/man/man3/mbtowc.3 b/man/man3/mbtowc.3 index 22f0cbc2e..ae994667d 100644 --- a/man/man3/mbtowc.3 +++ b/man/man3/mbtowc.3 @@ -13,9 +13,9 @@ Standard C library .nf .B #include .P -.BR "int mbtowc(" "size_t n;" -.BI " wchar_t *restrict " pwc ", const char " s "[restrict " n "], \ -size_t " n ); +.BR "int mbtowc(" "size_t size;" +.BI " wchar_t *restrict " pwc ", const char " s "[restrict " size ], +.BI " size_t " size ); .fi .SH DESCRIPTION The main case for this function is when @@ -27,7 +27,7 @@ not NULL. In this case, the .BR mbtowc () function inspects at most -.I n +.I size bytes of the multibyte string starting at .IR s , extracts the next complete @@ -44,7 +44,7 @@ of bytes that were consumed from otherwise it returns 0. .P If the -.I n +.I size bytes starting at .I s do not contain a complete multibyte @@ -52,7 +52,7 @@ character, or if they contain an invalid multibyte sequence, .BR mbtowc () returns \-1. This can happen even if -.I n +.I size >= .IR MB_CUR_MAX , if the multibyte string contains redundant shift sequences. @@ -73,7 +73,7 @@ is NULL. In this case, .I pwc and -.I n +.I size are ignored. The diff --git a/man/man3/pthread_setname_np.3 b/man/man3/pthread_setname_np.3 index 02ec1b377..e7aa6022e 100644 --- a/man/man3/pthread_setname_np.3 +++ b/man/man3/pthread_setname_np.3 @@ -16,8 +16,7 @@ POSIX threads library .P .BI "int pthread_setname_np(pthread_t " thread ", const char *" name ); .BR "int pthread_getname_np(" "size_t size;" -.BI " pthread_t " thread ", char " name [ size "], \ -size_t " size ); +.BI " pthread_t " thread ", char " name [ size "], size_t " size ); .fi .SH DESCRIPTION By default, all the threads created using diff --git a/man/man3/random_r.3 b/man/man3/random_r.3 index efa896095..b86ab5b57 100644 --- a/man/man3/random_r.3 +++ b/man/man3/random_r.3 @@ -18,9 +18,9 @@ Standard C library .BI " int32_t *restrict " result ); .BI "int srandom_r(unsigned int " seed ", struct random_data *" buf ); .P -.BI "int initstate_r(unsigned int " seed ", \ -char " statebuf "[restrict ." statelen ], -.BI " size_t " statelen ", struct random_data *restrict " buf ); +.BI "int initstate_r(unsigned int " seed , +.BI " char " statebuf "[restrict ." statelen "], size_t " statelen , +.BI " struct random_data *restrict " buf ); .BI "int setstate_r(char *restrict " statebuf , .BI " struct random_data *restrict " buf ); .fi diff --git a/man/man3/regex.3 b/man/man3/regex.3 index 6c37ecafe..21e9c4c0b 100644 --- a/man/man3/regex.3 +++ b/man/man3/regex.3 @@ -15,10 +15,9 @@ Standard C library .P .BI "int regcomp(regex_t *restrict " preg ", const char *restrict " regex , .BI " int " cflags ); -.BI "int regexec(const regex_t *restrict " preg \ -", const char *restrict " string , -.BI " size_t " nmatch ", \ -regmatch_t " pmatch "[_Nullable restrict " nmatch ], +.BI "int regexec(const regex_t *restrict " preg , +.BI " const char *restrict " string , +.BI " size_t " n ", regmatch_t " pmatch "[_Nullable restrict " n ], .BI " int " eflags ); .P .BR "size_t regerror(" "size_t errbuf_size;" @@ -64,7 +63,7 @@ Thus, a value of .I preg->re_nsub + 1 passed as -.I nmatch +.I n to .BR regexec () is sufficient to capture all matches. @@ -97,7 +96,7 @@ will use only for .BR REG_STARTEND , ignoring -.IR nmatch . +.IR n . .TP .B REG_NEWLINE Match-any-character operators don't match a newline. @@ -165,7 +164,7 @@ If any matches are returned wasn't passed to .BR regcomp (), the match succeeded, and -.I nmatch +.I n > 0), they overwrite .I pmatch as usual, and the match offsets remain relative to @@ -183,7 +182,7 @@ obtain the locations of matches within .IR string : .BR regexec () fills -.I nmatch +.I n elements of .I pmatch with results: @@ -192,7 +191,7 @@ corresponds to the entire match, .I pmatch[1] to the first subexpression, etc. If there were more matches than -.IR nmatch , +.IR n , they are discarded; if fewer, unused elements of diff --git a/man/man3/resolver.3 b/man/man3/resolver.3 index 7a16e8d5e..283caccb1 100644 --- a/man/man3/resolver.3 +++ b/man/man3/resolver.3 @@ -28,25 +28,27 @@ Resolver library .P .BR "int res_nquery(" "int anslen;" .BI " res_state " statep , -.BI " const char *" dname ", int " class ", int " type , +.BI " const char *" dname , +.BI " int " class ", int " type , .BI " unsigned char " answer [ anslen "], int " anslen ); .P .BR "int res_nsearch(" "int anslen;" .BI " res_state " statep , -.BI " const char *" dname ", int " class ", int " type , +.BI " const char *" dname , +.BI " int " class ", int " type , .BI " unsigned char " answer [ anslen "], int " anslen ); .P .BR "int res_nquerydomain(" "int anslen;" .BI " res_state " statep , .BI " const char *" name ", const char *" domain , -.BI " int " class ", int " type ", unsigned char " answer [ anslen ], -.BI " int " anslen ); +.BI " int " class ", int " type , +.BI " unsigned char " answer [ anslen "], int " anslen ); .P .BR "int res_nmkquery(" "int datalen, int buflen;" -.BI " res_state " statep , -.BI " int " op ", const char *" dname ", int " class , -.BI " int " type ", const unsigned char " data [ datalen "], \ -int " datalen , +.BI " res_state " statep ", int " op , +.BI " const char *" dname , +.BI " int " class ", int " type , +.BI " const unsigned char " data [ datalen "], int " datalen , .BI " const unsigned char *" newrr , .BI " unsigned char " buf [ buflen "], int " buflen ); .P @@ -56,15 +58,16 @@ int " datalen , .BI " unsigned char " answer [ anslen "], int " anslen ); .P .BR "int dn_comp(" "int length;" -.BI " const char *" exp_dn ", unsigned char " comp_dn [ length ], -.BI " int " length ", unsigned char **" dnptrs , +.BI " const char *" exp_dn , +.BI " unsigned char " comp_dn [ length "], int " length , +.BI " unsigned char **" dnptrs , .BI " unsigned char **" lastdnptr ); .P .BR "int dn_expand(" "int length;" .BI " const unsigned char *" msg , .BI " const unsigned char *" eomorig , -.BI " const unsigned char *" comp_dn ", char " exp_dn [ length ], -.BI " int " length ); +.BI " const unsigned char *" comp_dn , +.BI " char " exp_dn [ length "], int " length ); .P .B [[deprecated]] extern struct __res_state _res; .P @@ -72,25 +75,28 @@ int " datalen , .P .B [[deprecated]] .BR "int res_query(" "int anslen;" -.BI " const char *" dname ", int " class ", int " type , +.BI " const char *" dname , +.BI " int " class ", int " type , .BI " unsigned char " answer [ anslen "], int " anslen ); .P .B [[deprecated]] .BR "int res_search(" "int anslen;" -.BI " const char *" dname ", int " class ", int " type , +.BI " const char *" dname , +.BI " int " class ", int " type , .BI " unsigned char " answer [ anslen "], int " anslen ); .P .B [[deprecated]] .BR "int res_querydomain(" "int anslen;" .BI " const char *" name ", const char *" domain , -.BI " int " class ", int " type ", unsigned char " answer [ anslen ], -.BI " int " anslen ); +.BI " int " class ", int " type , +.BI " unsigned char " answer [ anslen "], int " anslen ); .P .B [[deprecated]] .BR "int res_mkquery(" "int datalen, int buflen;" -.BI " int " op ", const char *" dname ", int " class , -.BI " int " type ", const unsigned char " data [ datalen "], \ -int " datalen , +.BI " int " op , +.BI " const char *" dname , +.BI " int " class ", int " type , +.BI " const unsigned char " data [ datalen "], int " datalen , .BI " const unsigned char *" newrr , .BI " unsigned char " buf [ buflen "], int " buflen ); .P diff --git a/man/man3/stpncpy.3 b/man/man3/stpncpy.3 index 0e8225ed6..7a2bc5707 100644 --- a/man/man3/stpncpy.3 +++ b/man/man3/stpncpy.3 @@ -17,12 +17,10 @@ Standard C library .B #include .P .BR "char *strncpy(" "size_t dsize;" -.BI " char " dst "[restrict " dsize "], \ -const char *restrict " src , +.BI " char " dst "[restrict " dsize "], const char *restrict " src , .BI " size_t " dsize ); .BR "char *stpncpy(" "size_t dsize;" -.BI " char " dst "[restrict " dsize "], \ -const char *restrict " src , +.BI " char " dst "[restrict " dsize "], const char *restrict " src , .BI " size_t " dsize ); .fi .P diff --git a/man/man3/strcasecmp.3 b/man/man3/strcasecmp.3 index 8db52225b..f8e6d9090 100644 --- a/man/man3/strcasecmp.3 +++ b/man/man3/strcasecmp.3 @@ -15,8 +15,7 @@ Standard C library .P .BI "int strcasecmp(const char *" s1 ", const char *" s2 ); .BR "int strncasecmp(" "size_t n;" -.BI " const char " s1 [ n "], const char " s2 [ n "], \ -size_t " n ); +.BI " const char " s1 [ n "], const char " s2 [ n "], size_t " n ); .fi .SH DESCRIPTION The diff --git a/man/man3/strfmon.3 b/man/man3/strfmon.3 index 2a469c1c6..f201f47c4 100644 --- a/man/man3/strfmon.3 +++ b/man/man3/strfmon.3 @@ -13,12 +13,11 @@ Standard C library .nf .B #include .P -.BR "ssize_t strfmon(" "size_t max;" -.BI " char " s "[restrict " max "], size_t " max , +.BR "ssize_t strfmon(" "size_t size;" +.BI " char " s "[restrict " size "], size_t " size , .BI " const char *restrict " format ", ...);" -.BR "ssize_t strfmon_l(" "size_t max;" -.BI " char " s "[restrict " max "], size_t " max ", \ -locale_t " locale , +.BR "ssize_t strfmon_l(" "size_t size;" +.BI " char " s "[restrict " size "], size_t " size ", locale_t " l , .BI " const char *restrict " format ", ...);" .fi .SH DESCRIPTION @@ -31,19 +30,20 @@ and format specification and places the result in the character array .I s -of size -.IR max . +of +.I size +bytes. .P The .BR strfmon_l () function performs the same task, but uses the locale specified by -.IR locale . +.IR l . The behavior of .BR strfmon_l () is undefined if -.I locale +.I l is the special locale object .B LC_GLOBAL_LOCALE (see diff --git a/man/man3/strxfrm.3 b/man/man3/strxfrm.3 index 9c408d550..b1b2fb490 100644 --- a/man/man3/strxfrm.3 +++ b/man/man3/strxfrm.3 @@ -13,10 +13,9 @@ Standard C library .nf .B #include .P -.BR "size_t strxfrm(" "size_t n;" -.BI " char " dest "[restrict " n "], \ -const char " src "[restrict " n ], -.BI " size_t " n ); +.BR "size_t strxfrm(" "size_t size;" +.BI " char " dest "[restrict " size "], const char " src "[restrict " size ], +.BI " size_t " size ); .fi .SH DESCRIPTION The @@ -33,7 +32,7 @@ is the same as the result of .BR strcoll (3) on the two strings before their transformation. The first -.I n +.I size bytes of the transformed string are placed in .IR dest . The transformation is based on the program's current @@ -50,7 +49,7 @@ store the transformed string in excluding the terminating null byte (\[aq]\[rs]0\[aq]). If the value returned is -.I n +.I size or more, the contents of .I dest diff --git a/man/man3/wcscasecmp.3 b/man/man3/wcscasecmp.3 index a8f1c897d..2a9bc1478 100644 --- a/man/man3/wcscasecmp.3 +++ b/man/man3/wcscasecmp.3 @@ -18,8 +18,7 @@ Standard C library .P .BI "int wcscasecmp(const wchar_t *" s1 ", const wchar_t *" s2 ); .BR "int wcsncasecmp(" "size_t n;" -.BI " const wchar_t " s1 [ n "], const wchar_t " s2 [ n "], \ -size_t " n ); +.BI " const wchar_t " s1 [ n "], const wchar_t " s2 [ n "], size_t " n ); .fi .P .RS -4 diff --git a/man/man3/wcsncmp.3 b/man/man3/wcsncmp.3 index 873ea3da3..71e87621f 100644 --- a/man/man3/wcsncmp.3 +++ b/man/man3/wcsncmp.3 @@ -14,8 +14,7 @@ Standard C library .B #include .P .BR "int wcsncmp(" "size_t n;" -.BI " const wchar_t " s1 [ n "], const wchar_t " s2 [ n "], \ -size_t " n ); +.BI " const wchar_t " s1 [ n "], const wchar_t " s2 [ n "], size_t " n ); .fi .SH DESCRIPTION The diff --git a/man/man3/wcsnrtombs.3 b/man/man3/wcsnrtombs.3 index 703645423..ee9167ca1 100644 --- a/man/man3/wcsnrtombs.3 +++ b/man/man3/wcsnrtombs.3 @@ -13,11 +13,10 @@ Standard C library .nf .B #include .P -.BR "size_t wcsnrtombs(" "size_t size;" -.BI " char " dest "[restrict " size "], \ -const wchar_t **restrict " src , -.BI " size_t " nwc ", size_t " size ", \ -mbstate_t *restrict " ps ); +.BR "size_t wcsnrtombs(" "size_t dsize;" +.BI " char " dest "[restrict " dsize ], +.BI " const wchar_t **restrict " src , +.BI " size_t " nwc ", size_t " dsize ", mbstate_t *restrict " ps ); .fi .P .RS -4 @@ -58,7 +57,7 @@ the wide-character string to a multibyte string starting at .IR dest . At most -.I size +.I dsize bytes are written to .IR dest . The shift state @@ -115,7 +114,7 @@ returned. If .I dest is NULL, -.I size +.I dsize is ignored, and the conversion proceeds as above, except that the converted bytes are not written out to memory, and that @@ -130,7 +129,7 @@ state known only to the function is used instead. .P The programmer must ensure that there is room for at least -.I size +.I dsize bytes at .IR dest . diff --git a/man/man3/wcsrtombs.3 b/man/man3/wcsrtombs.3 index 541bc144b..0c0470b6a 100644 --- a/man/man3/wcsrtombs.3 +++ b/man/man3/wcsrtombs.3 @@ -13,10 +13,10 @@ Standard C library .nf .B #include .P -.BR "size_t wcsrtombs(" "size_t size;" -.BI " char " dest "[restrict " size "], \ -const wchar_t **restrict " src , -.BI " size_t " size ", mbstate_t *restrict " ps ); +.BR "size_t wcsrtombs(" "size_t dsize;" +.BI " char " dest "[restrict " dsize ], +.BI " const wchar_t **restrict " src , +.BI " size_t " dsize ", mbstate_t *restrict " ps ); .fi .SH DESCRIPTION If @@ -30,7 +30,7 @@ the wide-character string to a multibyte string starting at .IR dest . At most -.I size +.I dsize bytes are written to .IR dest . The shift state @@ -85,7 +85,7 @@ is returned. If .I dest is NULL, -.I size +.I dsize is ignored, and the conversion proceeds as above, except that the converted bytes are not written out to memory, and that @@ -100,7 +100,7 @@ state known only to the function is used instead. .P The programmer must ensure that there is room for at least -.I size +.I dsize bytes at .IR dest . diff --git a/man/man3/wcstombs.3 b/man/man3/wcstombs.3 index 7ef158212..46049dd5a 100644 --- a/man/man3/wcstombs.3 +++ b/man/man3/wcstombs.3 @@ -13,10 +13,9 @@ Standard C library .nf .B #include .P -.BR "size_t wcstombs(" "size_t n;" -.BI " char " dest "[restrict " n "], \ -const wchar_t *restrict " src , -.BI " size_t " n ); +.BR "size_t wcstombs(" "size_t dsize;" +.BI " char " dest "[restrict " dsize "], const wchar_t *restrict " src , +.BI " size_t " dsize ); .fi .SH DESCRIPTION If @@ -29,7 +28,7 @@ the wide-character string to a multibyte string starting at .IR dest . At most -.I n +.I dsize bytes are written to .IR dest . The sequence of characters placed in @@ -56,7 +55,7 @@ The number of bytes written to excluding the terminating null byte (\[aq]\[rs]0\[aq]), is returned. .P The programmer must ensure that there is room for at least -.I n +.I dsize bytes at .IR dest . @@ -64,13 +63,13 @@ at If .I dest is NULL, -.I n +.I dsize is ignored, and the conversion proceeds as above, except that the converted bytes are not written out to memory, and no length limit exists. .P In order to avoid the case 2 above, the programmer should make sure -.I n +.I dsize is greater than or equal to .IR "wcstombs(NULL,src,0)+1" . .SH RETURN VALUE diff --git a/man/man3/wmemcmp.3 b/man/man3/wmemcmp.3 index 453076034..6989027bd 100644 --- a/man/man3/wmemcmp.3 +++ b/man/man3/wmemcmp.3 @@ -14,8 +14,7 @@ Standard C library .B #include .P .BR "int wmemcmp(" "size_t n;" -.BI " const wchar_t " s1 [ n "], const wchar_t " s2 [ n "], \ -size_t " n ); +.BI " const wchar_t " s1 [ n "], const wchar_t " s2 [ n "], size_t " n ); .fi .SH DESCRIPTION The diff --git a/man/man3/wmemmove.3 b/man/man3/wmemmove.3 index 847d42805..75456a8fc 100644 --- a/man/man3/wmemmove.3 +++ b/man/man3/wmemmove.3 @@ -14,8 +14,7 @@ Standard C library .B #include .P .BR "wchar_t *wmemmove(" "size_t n;" -.BI " wchar_t " dest [ n "], const wchar_t " src [ n "], \ -size_t " n ); +.BI " wchar_t " dest [ n "], const wchar_t " src [ n "], size_t " n ); .fi .SH DESCRIPTION The diff --git a/man/man5/core.5 b/man/man5/core.5 index b1361eea0..d7ccc3c3c 100644 --- a/man/man5/core.5 +++ b/man/man5/core.5 @@ -609,8 +609,7 @@ The following shell session demonstrates the use of this program .RB "$" " cc \-o core_pattern_pipe_test core_pattern_pipe_test.c" .RB "$" " su" Password: -.RB "#" " echo \[dq]|$PWD/core_pattern_pipe_test %p \ -UID=%u GID=%g sig=%s\[dq] > \[rs]" +.RB "#" " echo \[dq]|$PWD/core_pattern_pipe_test %p UID=%u GID=%g sig=%s\[dq] > \[rs]" .B " /proc/sys/kernel/core_pattern" .RB "#" " exit" .RB "$" " sleep 100" diff --git a/man/man7/attributes.7 b/man/man7/attributes.7 index ed9e2bb4c..3a8df4377 100644 --- a/man/man7/attributes.7 +++ b/man/man7/attributes.7 @@ -88,8 +88,8 @@ safe for inlining. .\" environment cannot be performed atomically then it is also possible that .\" the environment encountered is internally inconsistent. .TP -.I MT-Unsafe \" ", " AS-Unsafe ", " AC-Unsafe -.I MT-Unsafe \" ", " AS-Unsafe ", " AC-Unsafe +.I MT-Unsafe \" ,\~ AS-Unsafe ,\~ AC-Unsafe +.I MT-Unsafe \" ,\~ AS-Unsafe ,\~ AC-Unsafe functions are not safe to call in a multithreaded programs. .\" functions are not .\" safe to call within the safety contexts described above. diff --git a/man/man7/string_copying.7 b/man/man7/string_copying.7 index cfefde305..9bb67f976 100644 --- a/man/man7/string_copying.7 +++ b/man/man7/string_copying.7 @@ -31,16 +31,13 @@ strncat .P // Copy/catenate a string with truncation. .BR "ssize_t strtcpy(" "size_t dsize;" -.BI " char " dst "[restrict " dsize "], \ -const char *restrict " src , +.BI " char " dst "[restrict " dsize "], const char *restrict " src , .BI " size_t " dsize ); .BR "size_t strlcpy(" "size_t dsize;" -.BI " char " dst "[restrict " dsize "], \ -const char *restrict " src , +.BI " char " dst "[restrict " dsize "], const char *restrict " src , .BI " size_t " dsize ); .BR "size_t strlcat(" "size_t dsize;" -.BI " char " dst "[restrict " dsize "], \ -const char *restrict " src , +.BI " char " dst "[restrict " dsize "], const char *restrict " src , .BI " size_t " dsize ); .fi .\" ----- SYNOPSIS :: Null-padded character sequences --------/ @@ -49,12 +46,10 @@ const char *restrict " src , // Fill a fixed-size buffer with characters from a string // and pad with null bytes. .BR "char *strncpy(" "size_t dsize;" -.BI " char " dst "[restrict " dsize "], \ -const char *restrict " src , +.BI " char " dst "[restrict " dsize "], const char *restrict " src , .BI " size_t " dsize ); .BR "char *stpncpy(" "size_t dsize;" -.BI " char " dst "[restrict " dsize "], \ -const char *restrict " src , +.BI " char " dst "[restrict " dsize "], const char *restrict " src , .BI " size_t " dsize ); .P // Chain-copy a null-padded character sequence into a character sequence. @@ -77,8 +72,7 @@ const char *restrict " src , .nf // Chain-copy a length-bounded character sequence. .BR "void *mempcpy(" "size_t len;" -.BI " void " dst "[restrict " len "], \ -const void " src "[restrict " len ], +.BI " void " dst "[restrict " len "], const void " src "[restrict " len ], .BI " size_t " len ); .P // Chain-copy a length-bounded character sequence into a string. diff --git a/man/man7/tcp.7 b/man/man7/tcp.7 index 3a549470b..1a74c5ed8 100644 --- a/man/man7/tcp.7 +++ b/man/man7/tcp.7 @@ -583,8 +583,7 @@ application timeouts may be much shorter. .\" .\" The following is from Linux 2.6.12: Documentation/networking/ip-sysctl.txt .TP -.IR tcp_low_latency " (Boolean; default: disabled; since Linux 2.4.21/2.6; \ -obsolete since Linux 4.14)" +.IR tcp_low_latency " (Boolean; default: disabled; since Linux 2.4.21/2.6; obsolete since Linux 4.14)" .\" Since Linux 2.4.21/2.5.60 If enabled, the TCP stack makes decisions that prefer lower latency as opposed to higher throughput.