]> git.ipfire.org Git - thirdparty/man-pages.git/commit
man/: SYNOPSIS: Don't highlight forward declarations of function parameters
authorAlejandro Colomar <alx@kernel.org>
Fri, 6 Jun 2025 11:27:02 +0000 (13:27 +0200)
committerAlejandro Colomar <alx@kernel.org>
Sat, 28 Jun 2025 14:51:43 +0000 (16:51 +0200)
commit8eea66b827a11bc8983da517499cc236c6cd97ba
treeaef545da6666369425609c27752453f9f9cf45d8
parent6569dd9b22d256f26928ddcc398db9f123546171
man/: SYNOPSIS: Don't highlight forward declarations of function parameters

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>
139 files changed:
man/man2/add_key.2
man/man2/alloc_hugepages.2
man/man2/cacheflush.2
man/man2/epoll_wait.2
man/man2/get_mempolicy.2
man/man2/getdents.2
man/man2/getdomainname.2
man/man2/getrandom.2
man/man2/getsockopt.2
man/man2/getunwind.2
man/man2/getxattr.2
man/man2/init_module.2
man/man2/listmount.2
man/man2/lookup_dcookie.2
man/man2/madvise.2
man/man2/mbind.2
man/man2/mincore.2
man/man2/mlock.2
man/man2/mmap.2
man/man2/modify_ldt.2
man/man2/mprotect.2
man/man2/mremap.2
man/man2/msgop.2
man/man2/msync.2
man/man2/outb.2
man/man2/perfmonctl.2
man/man2/pread.2
man/man2/query_module.2
man/man2/read.2
man/man2/readlink.2
man/man2/recv.2
man/man2/remap_file_pages.2
man/man2/s390_pci_mmio_write.2
man/man2/send.2
man/man2/setxattr.2
man/man2/write.2
man/man2const/KEYCTL_DESCRIBE.2const
man/man2const/KEYCTL_DH_COMPUTE.2const
man/man2const/KEYCTL_GET_SECURITY.2const
man/man2const/KEYCTL_INSTANTIATE.2const
man/man2const/KEYCTL_READ.2const
man/man2const/KEYCTL_UPDATE.2const
man/man2const/PR_GET_AUXV.2const
man/man3/aio_suspend.3
man/man3/arc4random.3
man/man3/backtrace.3
man/man3/bcmp.3
man/man3/bcopy.3
man/man3/bsearch.3
man/man3/bstring.3
man/man3/bzero.3
man/man3/cfree.3
man/man3/confstr.3
man/man3/des_crypt.3
man/man3/fgetc.3
man/man3/fgetws.3
man/man3/fmemopen.3
man/man3/fread.3
man/man3/getcwd.3
man/man3/getdirentries.3
man/man3/getentropy.3
man/man3/getgrent_r.3
man/man3/getgrnam.3
man/man3/gethostbyname.3
man/man3/getipnodebyname.3
man/man3/getlogin.3
man/man3/getmntent.3
man/man3/getnameinfo.3
man/man3/getnetent_r.3
man/man3/getprotoent_r.3
man/man3/getpwent_r.3
man/man3/getpwnam.3
man/man3/getrpcent_r.3
man/man3/getservent_r.3
man/man3/getspnam.3
man/man3/inet_net_pton.3
man/man3/inet_ntop.3
man/man3/lio_listio.3
man/man3/lsearch.3
man/man3/mblen.3
man/man3/mbrlen.3
man/man3/mbrtowc.3
man/man3/mbsnrtowcs.3
man/man3/mbsrtowcs.3
man/man3/mbstowcs.3
man/man3/mbtowc.3
man/man3/memccpy.3
man/man3/memchr.3
man/man3/memcmp.3
man/man3/memcpy.3
man/man3/memfrob.3
man/man3/memmem.3
man/man3/memmove.3
man/man3/mempcpy.3
man/man3/memset.3
man/man3/mq_receive.3
man/man3/mq_send.3
man/man3/posix_madvise.3
man/man3/printf.3
man/man3/pthread_attr_setstack.3
man/man3/pthread_setname_np.3
man/man3/ptsname.3
man/man3/qsort.3
man/man3/random.3
man/man3/regex.3
man/man3/resolver.3
man/man3/setaliasent.3
man/man3/setbuf.3
man/man3/setnetgrent.3
man/man3/stpncpy.3
man/man3/strcasecmp.3
man/man3/strcmp.3
man/man3/strdup.3
man/man3/strerror.3
man/man3/strfmon.3
man/man3/strfromd.3
man/man3/strftime.3
man/man3/strncat.3
man/man3/strnlen.3
man/man3/strxfrm.3
man/man3/swab.3
man/man3/ttyname.3
man/man3/unlocked_stdio.3
man/man3/wcpncpy.3
man/man3/wcscasecmp.3
man/man3/wcsncat.3
man/man3/wcsncmp.3
man/man3/wcsncpy.3
man/man3/wcsnlen.3
man/man3/wcsnrtombs.3
man/man3/wcsrtombs.3
man/man3/wcstombs.3
man/man3/wmemchr.3
man/man3/wmemcmp.3
man/man3/wmemcpy.3
man/man3/wmemmove.3
man/man3/wmemset.3
man/man3/wprintf.3
man/man7/string_copying.7