diff options
| author | Alex Colomar <alx.manpages@gmail.com> | 2022-09-18 01:09:59 +0200 |
|---|---|---|
| committer | Alejandro Colomar <alx@kernel.org> | 2022-11-10 00:53:45 +0100 |
| commit | c64cd13e002561c6802c6a1a1a8a640f034fea70 (patch) | |
| tree | 6aa203e7d7d6a36fdd457994a78fc10c3b10d8ca | |
| parent | 77f31ff920bc0abdf73ee4ece808ba4eeeff90a4 (diff) | |
| download | man-pages-c64cd13e002561c6802c6a1a1a8a640f034fea70.tar.gz | |
Various pages: SYNOPSIS: Use VLA syntax in 'void *' function parameters
Use VLA syntax also for void *, even if it's a bit more weird.
Link: <https://www.open-std.org/jtc1/sc22/wg14/www/docs/n2611.htm>
Cc: Ingo Schwarze <schwarze@openbsd.org>
Cc: JeanHeyd Meneide <wg14@soasis.org>
Cc: Martin Uecker <uecker@tugraz.at>
Cc: <gcc@gcc.gnu.org>
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>
59 files changed, 162 insertions, 128 deletions
diff --git a/man2/add_key.2 b/man2/add_key.2 index c3a91b0069..f6101cfd65 100644 --- a/man2/add_key.2 +++ b/man2/add_key.2 @@ -15,7 +15,7 @@ Standard C library .B #include <keyutils.h> .PP .BI "key_serial_t add_key(const char *" type ", const char *" description , -.BI " const void *" payload ", size_t " plen , +.BI " const void " payload [. plen "], size_t " plen , .BI " key_serial_t " keyring ");" .fi .PP diff --git a/man2/alloc_hugepages.2 b/man2/alloc_hugepages.2 index aaa3657379..b1bd0e31c1 100644 --- a/man2/alloc_hugepages.2 +++ b/man2/alloc_hugepages.2 @@ -7,8 +7,8 @@ alloc_hugepages, free_hugepages \- allocate or free huge pages .SH SYNOPSIS .nf -.BI "void *syscall(SYS_alloc_hugepages, int " key ", void *" addr \ -", size_t " len , +.BI "void *syscall(SYS_alloc_hugepages, int " key ", void " addr [. len "], \ +size_t " len , .BI " int " prot ", int " flag ); .\" asmlinkage unsigned long sys_alloc_hugepages(int key, unsigned long addr, .\" unsigned long len, int prot, int flag); diff --git a/man2/cacheflush.2 b/man2/cacheflush.2 index 8d53cfbbc6..d80e75b2cf 100644 --- a/man2/cacheflush.2 +++ b/man2/cacheflush.2 @@ -13,7 +13,7 @@ Standard C library .nf .B #include <sys/cachectl.h> .PP -.BI "int cacheflush(void *" addr ", int "nbytes ", int "cache ); +.BI "int cacheflush(void " addr [. nbytes "], int "nbytes ", int "cache ); .fi .PP .IR Note : diff --git a/man2/getdents.2 b/man2/getdents.2 index 0403110995..0f43624c16 100644 --- a/man2/getdents.2 +++ b/man2/getdents.2 @@ -26,7 +26,7 @@ Standard C library .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" .B #include <dirent.h> .PP -.BI "ssize_t getdents64(int " fd ", void *" dirp ", size_t " count ); +.BI "ssize_t getdents64(int " fd ", void " dirp [. count "], size_t " count ); .fi .PP .IR Note : diff --git a/man2/getrandom.2 b/man2/getrandom.2 index 402a49d8de..bf5083383e 100644 --- a/man2/getrandom.2 +++ b/man2/getrandom.2 @@ -14,7 +14,8 @@ Standard C library .nf .B #include <sys/random.h> .PP -.BI "ssize_t getrandom(void *"buf ", size_t " buflen ", unsigned int " flags ); +.BI "ssize_t getrandom(void " buf [. buflen "], size_t " buflen ", \ +unsigned int " flags ); .fi .SH DESCRIPTION The diff --git a/man2/getsockopt.2 b/man2/getsockopt.2 index ad36b83408..d209413a49 100644 --- a/man2/getsockopt.2 +++ b/man2/getsockopt.2 @@ -24,9 +24,11 @@ Standard C library .B #include <sys/socket.h> .PP .BI "int getsockopt(int " sockfd ", int " level ", int " optname , -.BI " void *restrict " optval ", socklen_t *restrict " optlen ); +.BI " void " optval "[restrict *." optlen ], +.BI " socklen_t *restrict " optlen ); .BI "int setsockopt(int " sockfd ", int " level ", int " optname , -.BI " const void *" optval ", socklen_t " optlen ); +.BI " const void " optval [. optlen ], +.BI " socklen_t " optlen ); .fi .SH DESCRIPTION .BR getsockopt () diff --git a/man2/getunwind.2 b/man2/getunwind.2 index 93ef8259a6..99eae71212 100644 --- a/man2/getunwind.2 +++ b/man2/getunwind.2 @@ -16,8 +16,8 @@ Standard C library .BR "#include <sys/syscall.h>" " /* Definition of " SYS_* " constants */" .B #include <unistd.h> .PP -.BI "[[deprecated]] long syscall(SYS_getunwind, void " *buf \ -", size_t " buf_size ); +.BI "[[deprecated]] long syscall(SYS_getunwind, void " buf [. buf_size ], +.BI " size_t " buf_size ); .fi .SH DESCRIPTION .I Note: this system call is obsolete. diff --git a/man2/getxattr.2 b/man2/getxattr.2 index e509eb2af3..be08ac1ec3 100644 --- a/man2/getxattr.2 +++ b/man2/getxattr.2 @@ -14,11 +14,11 @@ Standard C library .B #include <sys/xattr.h> .PP .BI "ssize_t getxattr(const char *" path ", const char *" name , -.BI " void *" value ", size_t " size ); +.BI " void " value [. size "], size_t " size ); .BI "ssize_t lgetxattr(const char *" path ", const char *" name , -.BI " void *" value ", size_t " size ); +.BI " void " value [. size "], size_t " size ); .BI "ssize_t fgetxattr(int " fd ", const char *" name , -.BI " void *" value ", size_t " size ); +.BI " void " value [. size "], size_t " size ); .fi .SH DESCRIPTION Extended attributes are diff --git a/man2/init_module.2 b/man2/init_module.2 index 8df668b0ca..0b43007011 100644 --- a/man2/init_module.2 +++ b/man2/init_module.2 @@ -16,10 +16,11 @@ Standard C library .BR "#include <sys/syscall.h>" " /* Definition of " SYS_* " constants */" .B #include <unistd.h> .PP -.BI "int syscall(SYS_init_module, void *" module_image ", unsigned long " len , +.BI "int syscall(SYS_init_module, void " module_image [. len "], \ +unsigned long " len , .BI " const char *" param_values ); -.BI "int syscall(SYS_finit_module, int " fd ", const char *" param_values , -.BI " int " flags ); +.BI "int syscall(SYS_finit_module, int " fd , +.BI " const char *" param_values ", int " flags ); .fi .PP .IR Note : diff --git a/man2/madvise.2 b/man2/madvise.2 index 66aaf70e96..9a3357b5ed 100644 --- a/man2/madvise.2 +++ b/man2/madvise.2 @@ -22,7 +22,7 @@ Standard C library .nf .B #include <sys/mman.h> .PP -.BI "int madvise(void *" addr ", size_t " length ", int " advice ); +.BI "int madvise(void " addr [. length "], size_t " length ", int " advice ); .fi .PP .RS -4 diff --git a/man2/mbind.2 b/man2/mbind.2 index 05c939da18..9811690c25 100644 --- a/man2/mbind.2 +++ b/man2/mbind.2 @@ -42,7 +42,7 @@ NUMA (Non-Uniform Memory Access) policy library .nf .B "#include <numaif.h>" .PP -.BI "long mbind(void *" addr ", unsigned long " len ", int " mode , +.BI "long mbind(void " addr [. len "], unsigned long " len ", int " mode , .BI " const unsigned long " nodemask [(. maxnode " + ULONG_WIDTH - 1)" .B " / ULONG_WIDTH]," .BI " unsigned long " maxnode ", unsigned int " flags ); diff --git a/man2/mincore.2 b/man2/mincore.2 index f8c240c6ed..98eaf8025e 100644 --- a/man2/mincore.2 +++ b/man2/mincore.2 @@ -21,7 +21,7 @@ Standard C library .nf .B #include <sys/mman.h> .PP -.BI "int mincore(void *" addr ", size_t " length ", unsigned char *" vec ); +.BI "int mincore(void " addr [. length "], size_t " length ", unsigned char *" vec ); .fi .PP .RS -4 diff --git a/man2/mlock.2 b/man2/mlock.2 index 9a6d04454a..c08e7ad5b5 100644 --- a/man2/mlock.2 +++ b/man2/mlock.2 @@ -14,9 +14,10 @@ Standard C library .nf .B #include <sys/mman.h> .PP -.BI "int mlock(const void *" addr ", size_t " len ); -.BI "int mlock2(const void *" addr ", size_t " len ", unsigned int " flags ); -.BI "int munlock(const void *" addr ", size_t " len ); +.BI "int mlock(const void " addr [. len "], size_t " len ); +.BI "int mlock2(const void " addr [. len "], size_t " len ", \ +unsigned int " flags ); +.BI "int munlock(const void " addr [. len "], size_t " len ); .PP .BI "int mlockall(int " flags ); .B int munlockall(void); diff --git a/man2/mmap.2 b/man2/mmap.2 index 87eb93d717..bdd51013f0 100644 --- a/man2/mmap.2 +++ b/man2/mmap.2 @@ -27,10 +27,10 @@ Standard C library .nf .B #include <sys/mman.h> .PP -.BI "void *mmap(void *" addr ", size_t " length \ +.BI "void *mmap(void " addr [. length "], size_t " length \ ", int " prot ", int " flags , .BI " int " fd ", off_t " offset ); -.BI "int munmap(void *" addr ", size_t " length ); +.BI "int munmap(void " addr [. length "], size_t " length ); .fi .PP See NOTES for information on feature test macro requirements. diff --git a/man2/modify_ldt.2 b/man2/modify_ldt.2 index 7a0c6b7149..e8ae9c9d0a 100644 --- a/man2/modify_ldt.2 +++ b/man2/modify_ldt.2 @@ -15,7 +15,7 @@ Standard C library .BR "#include <sys/syscall.h>" " /* Definition of " SYS_* " constants */" .B #include <unistd.h> .PP -.BI "int syscall(SYS_modify_ldt, int " func ", void *" ptr , +.BI "int syscall(SYS_modify_ldt, int " func ", void " ptr [. bytecount ], .BI " unsigned long " bytecount ); .fi .PP diff --git a/man2/move_pages.2 b/man2/move_pages.2 index 6a93ac8a1a..00f3aadd59 100644 --- a/man2/move_pages.2 +++ b/man2/move_pages.2 @@ -27,8 +27,10 @@ NUMA (Non-Uniform Memory Access) policy library .nf .B #include <numaif.h> .PP -.BI "long move_pages(int " pid ", unsigned long " count ", void **" pages , -.BI " const int *" nodes ", int *" status ", int " flags ); +.BI "long move_pages(int " pid ", unsigned long " count ", \ +void *" pages [. count ], +.BI " const int " nodes [. count "], int " status [. count "], \ +int " flags ); .fi .SH DESCRIPTION .BR move_pages () diff --git a/man2/mprotect.2 b/man2/mprotect.2 index debc6e8faa..066b7f4217 100644 --- a/man2/mprotect.2 +++ b/man2/mprotect.2 @@ -20,12 +20,12 @@ Standard C library .nf .B #include <sys/mman.h> .PP -.BI "int mprotect(void *" addr ", size_t " len ", int " prot ); +.BI "int mprotect(void " addr [. len "], size_t " len ", int " prot ); .PP .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" .B #include <sys/mman.h> .PP -.BI "int pkey_mprotect(void *" addr ", size_t " len ", int " prot ", int " pkey ");" +.BI "int pkey_mprotect(void " addr [. len "], size_t " len ", int " prot ", int " pkey ");" .fi .SH DESCRIPTION .BR mprotect () diff --git a/man2/mremap.2 b/man2/mremap.2 index fa3f60815e..81cda37650 100644 --- a/man2/mremap.2 +++ b/man2/mremap.2 @@ -19,7 +19,7 @@ Standard C library .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" .B #include <sys/mman.h> .PP -.BI "void *mremap(void *" old_address ", size_t " old_size , +.BI "void *mremap(void " old_address [. old_size "], size_t " old_size , .BI " size_t " new_size ", int " flags ", ... /* void *" new_address " */);" .fi .SH DESCRIPTION diff --git a/man2/msgop.2 b/man2/msgop.2 index 37deacd8a5..833e7cc849 100644 --- a/man2/msgop.2 +++ b/man2/msgop.2 @@ -27,10 +27,10 @@ Standard C library .nf .B #include <sys/msg.h> .PP -.BI "int msgsnd(int " msqid ", const void *" msgp ", size_t " msgsz \ -", int " msgflg ); +.BI "int msgsnd(int " msqid ", const void " msgp [. msgsz "], size_t " msgsz , +.BI " int " msgflg ); .PP -.BI "ssize_t msgrcv(int " msqid ", void *" msgp ", size_t " msgsz \ +.BI "ssize_t msgrcv(int " msqid ", void " msgp [. msgsz "], size_t " msgsz \ ", long " msgtyp , .BI " int " msgflg ); .fi diff --git a/man2/msync.2 b/man2/msync.2 index 78b6d5c8ed..b4c339e6d9 100644 --- a/man2/msync.2 +++ b/man2/msync.2 @@ -12,7 +12,7 @@ Standard C library .nf .B #include <sys/mman.h> .PP -.BI "int msync(void *" addr ", size_t " length ", int " flags ); +.BI "int msync(void " addr [. length "], size_t " length ", int " flags ); .fi .SH DESCRIPTION .BR msync () diff --git a/man2/outb.2 b/man2/outb.2 index 3746422645..90bedebd44 100644 --- a/man2/outb.2 +++ b/man2/outb.2 @@ -30,17 +30,17 @@ Standard C library .BI "void outl(unsigned int " value ", unsigned short " port ); .BI "void outl_p(unsigned int " value ", unsigned short " port ); .PP -.BI "void insb(unsigned short " port ", void *" addr , +.BI "void insb(unsigned short " port ", void " addr [. count ], .BI " unsigned long " count ); -.BI "void insw(unsigned short " port ", void *" addr , +.BI "void insw(unsigned short " port ", void " addr [. count ], .BI " unsigned long " count ); -.BI "void insl(unsigned short " port ", void *" addr , +.BI "void insl(unsigned short " port ", void " addr [. count ], .BI " unsigned long " count ); -.BI "void outsb(unsigned short " port ", const void *" addr , +.BI "void outsb(unsigned short " port ", const void " addr [. count ], .BI " unsigned long " count ); -.BI "void outsw(unsigned short " port ", const void *" addr , +.BI "void outsw(unsigned short " port ", const void " addr [. count ], .BI " unsigned long " count ); -.BI "void outsl(unsigned short " port ", const void *" addr , +.BI "void outsl(unsigned short " port ", const void " addr [. count ], .BI " unsigned long " count ); .fi .SH DESCRIPTION diff --git a/man2/perfmonctl.2 b/man2/perfmonctl.2 index 25ca916f72..e0ce38694b 100644 --- a/man2/perfmonctl.2 +++ b/man2/perfmonctl.2 @@ -12,7 +12,7 @@ perfmonctl \- interface to IA-64 performance monitoring unit .B #include <syscall.h> .B #include <perfmon.h> .PP -.BI "long perfmonctl(int " fd ", int " cmd ", void *" arg ", int " narg ");" +.BI "long perfmonctl(int " fd ", int " cmd ", void " arg [. narg "], int " narg ");" .fi .PP .IR Note : diff --git a/man2/pread.2 b/man2/pread.2 index 30afd1c3d6..df05c20801 100644 --- a/man2/pread.2 +++ b/man2/pread.2 @@ -12,10 +12,10 @@ Standard C library .nf .B #include <unistd.h> .PP -.BI "ssize_t pread(int " fd ", void *" buf ", size_t " count \ -", off_t " offset ); -.BI "ssize_t pwrite(int " fd ", const void *" buf ", size_t " count \ -", off_t " offset ); +.BI "ssize_t pread(int " fd ", void " buf [. count "], size_t " count , +.BI " off_t " offset ); +.BI "ssize_t pwrite(int " fd ", const void " buf [. count "], size_t " count , +.BI " off_t " offset ); .fi .PP .RS -4 diff --git a/man2/query_module.2 b/man2/query_module.2 index 61dcdd9101..c6ddd40ed6 100644 --- a/man2/query_module.2 +++ b/man2/query_module.2 @@ -12,9 +12,10 @@ query_module \- query the kernel for various bits pertaining to modules .nf .B #include <linux/module.h> .PP -.BI "[[deprecated]] int query_module(const char *" name ", int " which \ -", void *" buf , -.BI " size_t " bufsize ", size_t *" ret ); +.BI "[[deprecated]] int query_module(const char *" name ", int " which , +.BI " void " buf [. bufsize "], \ +size_t " bufsize , +.BI " size_t *" ret ); .fi .SH DESCRIPTION .IR Note : diff --git a/man2/read.2 b/man2/read.2 index 0482508583..401a1bd3f5 100644 --- a/man2/read.2 +++ b/man2/read.2 @@ -23,7 +23,7 @@ Standard C library .nf .B #include <unistd.h> .PP -.BI "ssize_t read(int " fd ", void *" buf ", size_t " count ); +.BI "ssize_t read(int " fd ", void " buf [. count "], size_t " count ); .fi .SH DESCRIPTION .BR read () diff --git a/man2/recv.2 b/man2/recv.2 index 1bb19e5611..d492976c47 100644 --- a/man2/recv.2 +++ b/man2/recv.2 @@ -20,9 +20,10 @@ Standard C library .nf .B #include <sys/socket.h> .PP -.BI "ssize_t recv(int " sockfd ", void *" buf ", size_t " len ", int " flags ); -.BI "ssize_t recvfrom(int " sockfd ", void *restrict " buf ", size_t " len \ -", int " flags , +.BI "ssize_t recv(int " sockfd ", void " buf [. len "], size_t " len , +.BI " int " flags ); +.BI "ssize_t recvfrom(int " sockfd ", void " buf "[restrict ." len "], size_t " len , +.BI " int " flags , .BI " struct sockaddr *restrict " src_addr , .BI " socklen_t *restrict " addrlen ); .BI "ssize_t recvmsg(int " sockfd ", struct msghdr *" msg ", int " flags ); diff --git a/man2/remap_file_pages.2 b/man2/remap_file_pages.2 index 4a01e938af..d4272f0dfc 100644 --- a/man2/remap_file_pages.2 +++ b/man2/remap_file_pages.2 @@ -16,9 +16,9 @@ Standard C library .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" .B #include <sys/mman.h> .PP -.BI "[[deprecated]] int remap_file_pages(void *" addr ", size_t " size \ -", int " prot , -.BI " size_t " pgoff ", int " flags ); +.BI "[[deprecated]] int remap_file_pages(void " addr [. size "], size_t " size , +.BI " int " prot ", size_t " pgoff ", \ +int " flags ); .fi .SH DESCRIPTION .BR Note : diff --git a/man2/s390_pci_mmio_write.2 b/man2/s390_pci_mmio_write.2 index bd366fab25..6a55a6e525 100644 --- a/man2/s390_pci_mmio_write.2 +++ b/man2/s390_pci_mmio_write.2 @@ -16,9 +16,10 @@ Standard C library .B #include <unistd.h> .PP .BI "int syscall(SYS_s390_pci_mmio_write, unsigned long " mmio_addr , -.BI " const void *" user_buffer ", size_t " length ); +.BI " const void " user_buffer [. length "], \ +size_t " length ); .BI "int syscall(SYS_s390_pci_mmio_read, unsigned long " mmio_addr , -.BI " void *" user_buffer ", size_t " length ); +.BI " void " user_buffer [. length "], size_t " length ); .fi .PP .IR Note : diff --git a/man2/send.2 b/man2/send.2 index 1d8ea7ac7e..86e40b0850 100644 --- a/man2/send.2 +++ b/man2/send.2 @@ -19,9 +19,9 @@ Standard C library .nf .B #include <sys/socket.h> .PP -.BI "ssize_t send(int " sockfd ", const void *" buf ", size_t " len \ +.BI "ssize_t send(int " sockfd ", const void " buf [. len "], size_t " len \ ", int " flags ); -.BI "ssize_t sendto(int " sockfd ", const void *" buf ", size_t " len \ +.BI "ssize_t sendto(int " sockfd ", const void " buf [. len "], size_t " len \ ", int " flags , .BI " const struct sockaddr *" dest_addr ", socklen_t " addrlen ); .BI "ssize_t sendmsg(int " sockfd ", const struct msghdr *" msg \ diff --git a/man2/setxattr.2 b/man2/setxattr.2 index 64c57281ac..aa7850dfe2 100644 --- a/man2/setxattr.2 +++ b/man2/setxattr.2 @@ -14,11 +14,11 @@ Standard C library .B #include <sys/xattr.h> .PP .BI "int setxattr(const char *" path ", const char *" name , -.BI " const void *" value ", size_t " size ", int " flags ); +.BI " const void " value [. size "], size_t " size ", int " flags ); .BI "int lsetxattr(const char *" path ", const char *" name , -.BI " const void *" value ", size_t " size ", int " flags ); +.BI " const void " value [. size "], size_t " size ", int " flags ); .BI "int fsetxattr(int " fd ", const char *" name , -.BI " const void *" value ", size_t " size ", int " flags ); +.BI " const void " value [. size "], size_t " size ", int " flags ); .fi .SH DESCRIPTION Extended attributes are diff --git a/man2/write.2 b/man2/write.2 index 073056d6ef..3135623a41 100644 --- a/man2/write.2 +++ b/man2/write.2 @@ -26,7 +26,7 @@ Standard C library .nf .B #include <unistd.h> .PP -.BI "ssize_t write(int " fd ", const void *" buf ", size_t " count ); +.BI "ssize_t write(int " fd ", const void " buf [. count "], size_t " count ); .fi .SH DESCRIPTION .BR write () diff --git a/man3/backtrace.3 b/man3/backtrace.3 index 552eaa173f..43c3612ad1 100644 --- a/man3/backtrace.3 +++ b/man3/backtrace.3 @@ -35,10 +35,11 @@ Standard C library .nf .B #include <execinfo.h> .PP -.BI "int backtrace(void **" buffer ", int " size ); +.BI "int backtrace(void *" buffer [. size "], int " size ); .PP -.BI "char **backtrace_symbols(void *const *" buffer ", int " size ); -.BI "void backtrace_symbols_fd(void *const *" buffer ", int " size ", int " fd ); +.BI "char **backtrace_symbols(void *const " buffer [. size "], int " size ); +.BI "void backtrace_symbols_fd(void *const " buffer [. size "], int " size ", \ +int " fd ); .fi .SH DESCRIPTION .BR backtrace () diff --git a/man3/bcmp.3 b/man3/bcmp.3 index ff06b5482c..8fe49189ea 100644 --- a/man3/bcmp.3 +++ b/man3/bcmp.3 @@ -18,7 +18,8 @@ Standard C library .nf .B #include <strings.h> .PP -.BI "[[deprecated]] int bcmp(const void *" s1 ", const void *" s2 ", size_t " n ); +.BI "[[deprecated]] int bcmp(const void " s1 [. n "], const void " s2 [. n "], \ +size_t " n ); .fi .SH DESCRIPTION The diff --git a/man3/bcopy.3 b/man3/bcopy.3 index 4ae82e34dd..10a41adecd 100644 --- a/man3/bcopy.3 +++ b/man3/bcopy.3 @@ -20,7 +20,8 @@ Standard C library .nf .B #include <strings.h> .PP -.BI "[[deprecated]] void bcopy(const void *" src ", void *" dest ", size_t " n ); +.BI "[[deprecated]] void bcopy(const void " src [. n "], void " dest [. n "], \ +size_t " n ); .fi .SH DESCRIPTION The diff --git a/man3/bsearch.3 b/man3/bsearch.3 index 02af77dcc8..2f77d4e9ae 100644 --- a/man3/bsearch.3 +++ b/man3/bsearch.3 @@ -18,9 +18,11 @@ Standard C library .nf .B #include <stdlib.h> .PP -.BI "void *bsearch(const void *" key ", const void *" base , +.BI "void *bsearch(const void " key [. size "], \ +const void " base [. size " * ." nmemb ], .BI " size_t " nmemb ", size_t " size , -.BI " int (*" compar ")(const void *, const void *));" +.BI " int (*" compar ")(const void [." size "], \ +const void [." size ])); .fi .SH DESCRIPTION The diff --git a/man3/bstring.3 b/man3/bstring.3 index 60b0b2bfeb..6a11bfa5f5 100644 --- a/man3/bstring.3 +++ b/man3/bstring.3 @@ -20,28 +20,29 @@ Standard C library .nf .B #include <string.h> .PP -.BI "int bcmp(const void *" s1 ", const void *" s2 ", size_t " n ); +.BI "int bcmp(const void " s1 [. n "], const void " s2 [. n "], size_t " n ); .PP -.BI "void bcopy(const void *" src ", void *" dest ", size_t " n ); +.BI "void bcopy(const void " src [. n "], void " dest [. n "], size_t " n ); .PP -.BI "void bzero(void *" s ", size_t " n ); +.BI "void bzero(void " s [. n "], size_t " n ); .PP -.BI "void *memccpy(void *" dest ", const void *" src ", int " c ", size_t " n ); +.BI "void *memccpy(void " dest [. n "], const void " src [. n "], int " c ", \ +size_t " n ); .PP -.BI "void *memchr(const void *" s ", int " c ", size_t " n ); +.BI "void *memchr(const void " s [. n "], int " c ", size_t " n ); .PP -.BI "int memcmp(const void *" s1 ", const void *" s2 ", size_t " n ); +.BI "int memcmp(const void " s1 [. n "], const void " s2 [. n "], size_t " n ); .PP -.BI "void *memcpy(void *" dest ", const void *" src ", size_t " n ); +.BI "void *memcpy(void " dest [. n "], const void " src [. n "], size_t " n ); .PP -.BI "void *memfrob(void *" s ", size_t " n ); +.BI "void *memfrob(void " s [. n "], size_t " n ); .PP -.BI "void *memmem(const void *" haystack ", size_t " haystacklen , -.BI " const void *" needle ", size_t " needlelen ); +.BI "void *memmem(const void " haystack [. haystacklen "], size_t " haystacklen , +.BI " const void " needle [. needlelen "], size_t " needlelen ); .PP -.BI "void *memmove(void *" dest ", const void *" src ", size_t " n ); +.BI "void *memmove(void " dest [. n "], const void " src [. n "], size_t " n ); .PP -.BI "void *memset(void *" s ", int " c ", size_t " n ); +.BI "void *memset(void " s [. n "], int " c ", size_t " n ); .fi .SH DESCRIPTION The byte string functions perform operations on strings (byte arrays) diff --git a/man3/bzero.3 b/man3/bzero.3 index 34fecc7709..c2c4abcbe1 100644 --- a/man3/bzero.3 +++ b/man3/bzero.3 @@ -12,11 +12,11 @@ Standard C library .nf .B #include <strings.h> .PP -.BI "void bzero(void *" s ", size_t " n ); +.BI "void bzero(void " s [. n "], size_t " n ); .PP .B #include <string.h> .PP -.BI "void explicit_bzero(void *" s ", size_t " n ); +.BI "void explicit_bzero(void " s [. n "], size_t " n ); .fi .SH DESCRIPTION The diff --git a/man3/cfree.3 b/man3/cfree.3 index 434bb86c5e..1b993b1752 100644 --- a/man3/cfree.3 +++ b/man3/cfree.3 @@ -20,10 +20,12 @@ Standard C library .BI "void cfree(void *" ptr ); .PP /* In SCO OpenServer */ -.BI "void cfree(char *" ptr ", unsigned int " num ", unsigned int " size ); +.BI "void cfree(char " ptr [. size " * ." num "], unsigned int " num ", \ +unsigned int " size ); .PP /* In Solaris watchmalloc.so.1 */ -.BI "void cfree(void *" ptr ", size_t " nelem ", size_t " elsize ); +.BI "void cfree(void " ptr [. elsize " * ." nelem "], size_t " nelem ", \ +size_t " elsize ); .fi .PP .RS -4 diff --git a/man3/fmemopen.3 b/man3/fmemopen.3 index ebccfbd09e..89f1dcf5e7 100644 --- a/man3/fmemopen.3 +++ b/man3/fmemopen.3 @@ -12,7 +12,8 @@ Standard C library .nf .B #include <stdio.h> .PP -.BI "FILE *fmemopen(void *"buf ", size_t "size ", const char *" mode ");" +.BI "FILE *fmemopen(void " buf [. size "], size_t " size ", \ +const char *" mode ); .fi .PP .RS -4 diff --git a/man3/fread.3 b/man3/fread.3 index aee8fb506a..155d20b837 100644 --- a/man3/fread.3 +++ b/man3/fread.3 @@ -25,10 +25,11 @@ Standard C library .nf .B #include <stdio.h> .PP -.BI "size_t fread(void *restrict " ptr ", size_t " size ", size_t " nmemb , +.BI "size_t fread(void " ptr "[restrict ." size " * ." nmemb ], +.BI " size_t " size ", size_t " nmemb , .BI " FILE *restrict " stream ); -.BI "size_t fwrite(const void *restrict " ptr ", size_t " size \ -", size_t " nmemb , +.BI "size_t fwrite(const void " ptr "[restrict ." size " * ." nmemb ], +.BI " size_t " size ", size_t " nmemb , .BI " FILE *restrict " stream ); .fi .SH DESCRIPTION diff --git a/man3/getentropy.3 b/man3/getentropy.3 index aa249ad290..f105a0f68e 100644 --- a/man3/getentropy.3 +++ b/man3/getentropy.3 @@ -12,7 +12,7 @@ Standard C library .nf .B #include <unistd.h> .PP -.BI "int getentropy(void *" buffer ", size_t " length ); +.BI "int getentropy(void " buffer [. length "], size_t " length ); .fi .PP .RS -4 diff --git a/man3/gethostbyname.3 b/man3/gethostbyname.3 index d9a5d46095..6f7d5b2352 100644 --- a/man3/gethostbyname.3 +++ b/man3/gethostbyname.3 @@ -36,8 +36,8 @@ Standard C library .B [[deprecated]] extern int h_errno; .PP .BI "[[deprecated]] struct hostent *gethostbyname(const char *" name ); -.BI "[[deprecated]] struct hostent *gethostbyaddr(const void *" addr , -.BI " socklen_t " len ", int " type ); +.BI "[[deprecated]] struct hostent *gethostbyaddr(const void " addr [. len ], +.BI " socklen_t " len ", int " type ); .PP .BI "[[deprecated]] void herror(const char *" s ); .BI "[[deprecated]] const char *hstrerror(int " err ); @@ -55,8 +55,8 @@ Standard C library .BI " int *restrict " h_errnop ); .PP .B [[deprecated]] -.BI "int gethostbyaddr_r(const void *restrict " addr ", socklen_t " len \ -", int " type , +.BI "int gethostbyaddr_r(const void " addr "[restrict ." len "], socklen_t " len , +.BI " int " type , .BI " struct hostent *restrict " ret , .BI " char " buf "[restrict ." buflen "], size_t " buflen , .BI " struct hostent **restrict " result , diff --git a/man3/getipnodebyname.3 b/man3/getipnodebyname.3 index 6e60cee2ee..ed83ed5d2c 100644 --- a/man3/getipnodebyname.3 +++ b/man3/getipnodebyname.3 @@ -18,7 +18,7 @@ Standard C library .PP .BI "[[deprecated]] struct hostent *getipnodebyname(const char *" name ", int " af , .BI " int " flags ", int *" error_num ); -.BI "[[deprecated]] struct hostent *getipnodebyaddr(const void *" addr , +.BI "[[deprecated]] struct hostent *getipnodebyaddr(const void " addr [. len ], .BI " size_t " len ", int " af , .BI " int *" "error_num" ); .BI "[[deprecated]] void freehostent(struct hostent *" "ip" ); diff --git a/man3/inet_net_pton.3 b/man3/inet_net_pton.3 index 0af4478b04..566b49aae5 100644 --- a/man3/inet_net_pton.3 +++ b/man3/inet_net_pton.3 @@ -13,9 +13,11 @@ Resolver library .B #include <arpa/inet.h> .PP .BI "int inet_net_pton(int " af ", const char *" pres , -.BI " void *" netp ", size_t " nsize ); -.BI "char *inet_net_ntop(int " af ", const void *" netp ", int " bits , -.BI " char " pres [. psize "], size_t " psize ); +.BI " void " netp [. nsize "], size_t " nsize ); +.BI "char *inet_net_ntop(int " af , +.BI " const void " netp [(. bits " - CHAR_BIT + 1) / CHAR_BIT]," +.BI " int " bits , +.BI " char " pres [. psize "], size_t " psize ); .fi .PP .RS -4 diff --git a/man3/lsearch.3 b/man3/lsearch.3 index 24439f1505..47c40b2cbf 100644 --- a/man3/lsearch.3 +++ b/man3/lsearch.3 @@ -13,10 +13,16 @@ Standard C library .nf .B #include <search.h> .PP -.BI "void *lfind(const void *" key ", const void *" base ", size_t *" nmemb , -.BI " size_t " size ", int(*" compar ")(const void *, const void *));" -.BI "void *lsearch(const void *" key ", void *" base ", size_t *" nmemb , -.BI " size_t " size ", int(*" compar ")(const void *, const void *));" +.BI "void *lfind(const void " key [. size "], \ +const void " base [. size " * ." nmemb ], +.BI " size_t *" nmemb ", size_t " size , +.BI " int(*" compar ")(const void [." size "], \ +const void [." size ])); +.BI "void *lsearch(const void " key [. size "], \ +void " base [. size " * ." nmemb ], +.BI " size_t *" nmemb ", size_t " size , +.BI " int(*" compar ")(const void [." size "], \ +const void [." size ])); .fi .SH DESCRIPTION .BR lfind () diff --git a/man3/memccpy.3 b/man3/memccpy.3 index 4f61ab4e48..8fb089de77 100644 --- a/man3/memccpy.3 +++ b/man3/memccpy.3 @@ -17,7 +17,7 @@ Standard C library .nf .B #include <string.h> .PP -.BI "void *memccpy(void *restrict " dest ", const void *restrict " src , +.BI "void *memccpy(void " dest "[restrict ." n "], const void " src "[restrict ." n ], .BI " int " c ", size_t " n ); .fi .SH DESCRIPTION diff --git a/man3/memchr.3 b/man3/memchr.3 index 2623632abb..fccb3f6bd3 100644 --- a/man3/memchr.3 +++ b/man3/memchr.3 @@ -19,9 +19,9 @@ Standard C library .nf .B #include <string.h> .PP -.BI "void *memchr(const void *" s ", int " c ", size_t " n ); -.BI "void *memrchr(const void *" s ", int " c ", size_t " n ); -.BI "void *rawmemchr(const void *" s ", int " c ); +.BI "void *memchr(const void " s [. n "], int " c ", size_t " n ); +.BI "void *memrchr(const void " s [. n "], int " c ", size_t " n ); +.BI "void *rawmemchr(const void " s [. n "], int " c ); .fi .PP .RS -4 diff --git a/man3/memcmp.3 b/man3/memcmp.3 index df2d1dd164..d9dfcaea5a 100644 --- a/man3/memcmp.3 +++ b/man3/memcmp.3 @@ -17,7 +17,7 @@ Standard C library .nf .B #include <string.h> .PP -.BI "int memcmp(const void *" s1 ", const void *" s2 ", size_t " n ); +.BI "int memcmp(const void " s1 [. n "], const void " s2 [. n "], size_t " n ); .fi .SH DESCRIPTION The diff --git a/man3/memcpy.3 b/man3/memcpy.3 index 484ad0dbb3..0767e65b53 100644 --- a/man3/memcpy.3 +++ b/man3/memcpy.3 @@ -18,8 +18,8 @@ Standard C library .nf .B #include <string.h> .PP -.BI "void *memcpy(void *restrict " dest ", const void *restrict " src \ -", size_t " n ); +.BI "void *memcpy(void " dest "[restrict ." n "], const void " src "[restrict ." n ], +.BI " size_t " n ); .fi .SH DESCRIPTION The diff --git a/man3/memfrob.3 b/man3/memfrob.3 index d47be00a47..691c2d4b46 100644 --- a/man3/memfrob.3 +++ b/man3/memfrob.3 @@ -18,7 +18,7 @@ Standard C library .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" .B #include <string.h> .PP -.BI "void *memfrob(void *" s ", size_t " n ); +.BI "void *memfrob(void " s [. n "], size_t " n ); .fi .SH DESCRIPTION The diff --git a/man3/memmem.3 b/man3/memmem.3 index 134dffab09..3b754e3b8c 100644 --- a/man3/memmem.3 +++ b/man3/memmem.3 @@ -18,8 +18,8 @@ Standard C library .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" .B #include <string.h> .PP -.BI "void *memmem(const void *" haystack ", size_t " haystacklen , -.BI " const void *" needle ", size_t " needlelen ); +.BI "void *memmem(const void " haystack [. haystacklen "], size_t " haystacklen , +.BI " const void " needle [. needlelen "], size_t " needlelen ); .fi .SH DESCRIPTION The diff --git a/man3/memmove.3 b/man3/memmove.3 index 3fe3662af5..1a475d0fcf 100644 --- a/man3/memmove.3 +++ b/man3/memmove.3 @@ -17,7 +17,7 @@ Standard C library .nf .B #include <string.h> .PP -.BI "void *memmove(void *" dest ", const void *" src ", size_t " n ); +.BI "void *memmove(void " dest [. n "], const void " src [. n "], size_t " n ); .fi .SH DESCRIPTION The diff --git a/man3/mempcpy.3 b/man3/mempcpy.3 index 9ba5889d68..b0d059dabe 100644 --- a/man3/mempcpy.3 +++ b/man3/mempcpy.3 @@ -16,8 +16,8 @@ Standard C library .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" .B #include <string.h> .PP -.BI "void *mempcpy(void *restrict " dest ", const void *restrict " src \ -", size_t " n ); +.BI "void *mempcpy(void " dest "[restrict ." n "], const void " src "[restrict ." n ], +.BI " size_t " n ); .PP .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" .B #include <wchar.h> diff --git a/man3/memset.3 b/man3/memset.3 index bc5d579084..a9cacf5238 100644 --- a/man3/memset.3 +++ b/man3/memset.3 @@ -17,7 +17,7 @@ Standard C library .nf .B #include <string.h> .PP -.BI "void *memset(void *" s ", int " c ", size_t " n ); +.BI "void *memset(void " s [. n "], int " c ", size_t " n ); .fi .SH DESCRIPTION The diff --git a/man3/posix_madvise.3 b/man3/posix_madvise.3 index 5e2575ec5d..2639900bc4 100644 --- a/man3/posix_madvise.3 +++ b/man3/posix_madvise.3 @@ -12,7 +12,7 @@ Standard C library .nf .B #include <sys/mman.h> .PP -.BI "int posix_madvise(void *" addr ", size_t " len ", int " advice ); +.BI "int posix_madvise(void " addr [. len "], size_t " len ", int " advice ); .fi .PP .RS -4 diff --git a/man3/pthread_attr_setstack.3 b/man3/pthread_attr_setstack.3 index 19b8e44ad4..b263698ff0 100644 --- a/man3/pthread_attr_setstack.3 +++ b/man3/pthread_attr_setstack.3 @@ -15,7 +15,8 @@ POSIX threads library .B #include <pthread.h> .PP .BI "int pthread_attr_setstack(pthread_attr_t *" attr , -.BI " void *" stackaddr ", size_t " stacksize ); +.BI " void " stackaddr [. stacksize ], +.BI " size_t " stacksize ); .BI "int pthread_attr_getstack(const pthread_attr_t *restrict " attr , .BI " void **restrict " stackaddr , .BI " size_t *restrict " stacksize ); diff --git a/man3/qsort.3 b/man3/qsort.3 index a401c5b667..bbd7b1986b 100644 --- a/man3/qsort.3 +++ b/man3/qsort.3 @@ -24,10 +24,14 @@ Standard C library .nf .B #include <stdlib.h> .PP -.BI "void qsort(void *" base ", size_t " nmemb ", size_t " size , -.BI " int (*" compar ")(const void *, const void *));" -.BI "void qsort_r(void *" base ", size_t " nmemb ", size_t " size , -.BI " int (*" compar ")(const void *, const void *, void *)," +.BI "void qsort(void " base [. size " * ." nmemb "], size_t " nmemb ", \ +size_t " size , +.BI " int (*" compar ")(const void [." size "], \ +const void [." size ])); +.BI "void qsort_r(void " base [. size " * ." nmemb "], size_t " nmemb ", \ +size_t " size , +.BI " int (*" compar ")(const void [." size "], \ +const void [." size "], void *)," .BI " void *" arg ");" .fi .PP diff --git a/man3/swab.3 b/man3/swab.3 index 06c6d9d291..44d5f84c8f 100644 --- a/man3/swab.3 +++ b/man3/swab.3 @@ -19,8 +19,8 @@ Standard C library .BR "#define _XOPEN_SOURCE" " /* See feature_test_macros(7) */" .B #include <unistd.h> .PP -.BI "void swab(const void *restrict " from ", void *restrict " to \ -", ssize_t " n ); +.BI "void swab(const void " from "[restrict ." n "], void " to "[restrict ." n ], +.BI " ssize_t " n ); .fi .SH DESCRIPTION The diff --git a/man3/unlocked_stdio.3 b/man3/unlocked_stdio.3 index ad15a632aa..a9b250149c 100644 --- a/man3/unlocked_stdio.3 +++ b/man3/unlocked_stdio.3 @@ -27,10 +27,11 @@ Standard C library .BI "int fgetc_unlocked(FILE *" stream ); .BI "int fputc_unlocked(int " c ", FILE *" stream ); .PP -.BI "size_t fread_unlocked(void *restrict " ptr ", size_t " size ", size_t " n , +.BI "size_t fread_unlocked(void " ptr "[restrict ." size " * ." n ], +.BI " size_t " size ", size_t " n , .BI " FILE *restrict " stream ); -.BI "size_t fwrite_unlocked(const void *restrict " ptr ", size_t " size \ -", size_t " n , +.BI "size_t fwrite_unlocked(const void " ptr "[restrict ." size " * ." n ], +.BI " size_t " size ", size_t " n , .BI " FILE *restrict " stream ); .PP .BI "char *fgets_unlocked(char " s "[restrict ." n "], int " n \ |