* [PATCH v2] man*/: ffix (migrate to `MR`)
@ 2023-07-31 17:52 G. Branden Robinson
2023-07-31 21:47 ` Alejandro Colomar
2023-07-31 22:16 ` Jakub Wilk
0 siblings, 2 replies; 17+ messages in thread
From: G. Branden Robinson @ 2023-07-31 17:52 UTC (permalink / raw)
To: Alejandro Colomar; +Cc: linux-man
[-- Attachment #1: Type: text/plain, Size: 64358 bytes --]
Use the man(7) macro `MR`, new to groff 1.23.0, instead of font style
alternation macros to mark up man page cross reference.
Background (from the groff 1.23.0 release announcement and "NEWS" file):
o The an (man) macro package supports a new macro, `MR`, intended for
use by man page cross references in preference to the font style
alternation macros historically used. Where before you would write
.BR ls (1).
or
.IR ls (1).
you should now write
.MR ls 1 .
(the third argument, typically used for trailing punctuation, is
optional). Because the macro semantically identifies a man page, it
can create a clickable hyperlink ("man:ls(1)" for the above example)
on supporting devices. Furthermore, a new string, `MF`, defines the
font to be used for setting the man page topic (the first argument to
`MR` and `TH`), permitting configuration by distributions, sites, and
users.
Inclusion of the `MR` macro was prompted by its introduction to
Plan 9 from User Space's troff in August 2020. Its purpose is to
ameliorate several long-standing problems with man page cross
references: (1) the package's lack of inherent hyperlink support for
them; (2) false-positive identification of strings resembling man page
cross references (as can happen with "exit(1)", "while(1)",
"sleep(5)", "time(0)" and others) by terminal emulators and other
programs; (3) the unwanted intrusion of hyphens into man page topics,
which frustrates copy-and-paste operations (this problem has always
been avoidable through use of the \% escape sequence, but cross
references are frequent in man pages and some page authors are
inexpert *roff users); and (4) deep divisions in man page maintenance
communities over which typeface should be used to set the man page
topic (italics, roman, or bold).
[...]
o The an (man) macro package can now produce clickable hyperlinks within
terminal emulators, using the OSC 8 support added to grotty(1) (see
below). The groff man(7) extension macros `UR` and `MT`, present
since 2007, expose this feature. At present the feature is disabled
by default in `man.local` pending more widespread recognition of OSC 8
sequences in pager programs. The package now recognizes a `U`
register to enable hyperlinks in any output driver supporting them.
Use a command like
printf '\033]8;;man:grotty(1)\033\\grotty(1)\033]8;;\033\\\n' | more
to check your terminal and pager for OSC 8 support. If you see
"grotty(1)" and no additional garbage characters, then you may wish to
edit "man.local" to remove the lines that disable this feature.
When the text of all Linux man-pages documents (excluding those
containing only `so` requests) is dumped, with adjustment mode 'l'
("-dAD=l") and automatic hyphenation disabled ("-rHY=0") before and
after this change, there is no change to rendered output.
When automatic hyphenation is enabled, this change suppresses
hyphenation of approximately 3,100+ man page names when cross referenced
when using the default terminal width of 80 (meaning that the text
is formatted for a line length of 78 for historical reasons).
I prepared this change with the following GNU sed script.
\# Handle simplest cases: ".BR foo (1)" and ".IR foo (1)".
s/^.[BI]R \(\\%\)*\([.@_[:alnum:]\\-]\+\) (\([1-9a-z]\+\))$/.MR \2 \3/
\# Handle case: trailing punctuation, as in ".IR foo (1),".
s/^.[BI]R \(\\%\)*\([.@_[:alnum:]\\-]\+\) (\([1-9a-z]\+\))\([^[:space:]]\+\)$/.MR \2 \3 \4/
\# Handle case: leading punctuation, as in ".RI ( foo (1)".
s/^.R[BI] \(\\%\)*\([^[:space:]]\+\) \([.@_[:alnum:]\\-]\+\) (\([1-9a-z]\+\))\([^[:space:]]\+\)$/\\%\2\\c\n.MR \3 \4 \5/
\# Handle case: 3rd+ arguments or trailing comments. This case is rare
\# and will require manual fixup if there are 4+ arguments to MR. Use
\# groff -man -rCHECKSTYLE=1 to have them automatically reported.
s/^.[BI]R \(\\%\)*\([.@_[:alnum:]\\-]\+\) (\([1-8a-z]\+\))\( .*\)/.MR \2 \3\4/
Confirmed no errors arising in `MR` argument count as follows.
$ groff --version | head -n 1
GNU groff version 1.23.0
$ groff -z -t -rCHECKSTYLE=1 -m andoc -T utf8 -P -cbou \
$(grep -L '^\.so ' man*/* | sort) 2>&1 | grep MR | grep . \
|| echo "IT'S CLEAN"
IT'S CLEAN
Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>
---
man1/getent.1 | 120 ++---
man1/iconv.1 | 24 +-
man1/intro.1 | 54 +--
man1/ldd.1 | 16 +-
man1/locale.1 | 16 +-
man1/localedef.1 | 15 +-
man1/memusage.1 | 58 +--
man1/memusagestat.1 | 8 +-
man1/mtrace.1 | 10 +-
man1/pldd.1 | 12 +-
man1/sprof.1 | 6 +-
man1/time.1 | 32 +-
man2/_exit.2 | 44 +-
man2/_syscall.2 | 12 +-
man2/accept.2 | 46 +-
man2/access.2 | 42 +-
man2/acct.2 | 8 +-
man2/add_key.2 | 41 +-
man2/adjtimex.2 | 26 +-
man2/alarm.2 | 30 +-
man2/alloc_hugepages.2 | 4 +-
man2/arch_prctl.2 | 22 +-
man2/bdflush.2 | 6 +-
man2/bind.2 | 48 +-
man2/bpf.2 | 28 +-
man2/brk.2 | 14 +-
man2/cacheflush.2 | 2 +-
man2/capget.2 | 26 +-
man2/chdir.2 | 14 +-
man2/chmod.2 | 38 +-
man2/chown.2 | 30 +-
man2/chroot.2 | 26 +-
man2/clock_getres.2 | 58 +--
man2/clock_nanosleep.2 | 42 +-
man2/clone.2 | 217 ++++-----
man2/close.2 | 42 +-
man2/close_range.2 | 16 +-
man2/connect.2 | 32 +-
man2/copy_file_range.2 | 10 +-
man2/create_module.2 | 8 +-
man2/delete_module.2 | 18 +-
man2/dup.2 | 28 +-
man2/epoll_create.2 | 14 +-
man2/epoll_ctl.2 | 46 +-
man2/epoll_wait.2 | 26 +-
man2/eventfd.2 | 108 ++---
man2/execve.2 | 134 +++---
man2/execveat.2 | 22 +-
man2/exit_group.2 | 6 +-
man2/fallocate.2 | 32 +-
man2/fanotify_init.2 | 42 +-
man2/fanotify_mark.2 | 44 +-
man2/fcntl.2 | 252 +++++-----
man2/flock.2 | 58 +--
man2/fork.2 | 119 ++---
man2/fsync.2 | 40 +-
man2/futex.2 | 34 +-
man2/futimesat.2 | 26 +-
man2/get_kernel_syms.2 | 12 +-
man2/get_mempolicy.2 | 32 +-
man2/get_robust_list.2 | 18 +-
man2/getcpu.2 | 16 +-
man2/getdents.2 | 16 +-
man2/getdomainname.2 | 14 +-
man2/getgid.2 | 10 +-
man2/getgroups.2 | 26 +-
man2/gethostname.2 | 16 +-
man2/getitimer.2 | 29 +-
man2/getpagesize.2 | 8 +-
man2/getpeername.2 | 26 +-
man2/getpid.2 | 46 +-
man2/getpriority.2 | 22 +-
man2/getrandom.2 | 20 +-
man2/getresuid.2 | 10 +-
man2/getrlimit.2 | 140 +++---
man2/getrusage.2 | 18 +-
man2/getsid.2 | 10 +-
man2/getsockname.2 | 12 +-
man2/getsockopt.2 | 26 +-
man2/gettid.2 | 38 +-
man2/gettimeofday.2 | 38 +-
man2/getuid.2 | 10 +-
man2/getunwind.2 | 4 +-
man2/getxattr.2 | 30 +-
man2/init_module.2 | 16 +-
man2/inotify_add_watch.2 | 14 +-
man2/inotify_init.2 | 14 +-
man2/inotify_rm_watch.2 | 8 +-
man2/intro.2 | 54 +--
man2/io_cancel.2 | 14 +-
man2/io_destroy.2 | 14 +-
man2/io_getevents.2 | 22 +-
man2/io_setup.2 | 16 +-
man2/io_submit.2 | 30 +-
man2/ioctl.2 | 34 +-
man2/ioctl_console.2 | 50 +-
man2/ioctl_fat.2 | 22 +-
man2/ioctl_ficlonerange.2 | 6 +-
man2/ioctl_fideduperange.2 | 6 +-
man2/ioctl_fslabel.2 | 6 +-
man2/ioctl_getfsmap.2 | 4 +-
man2/ioctl_iflags.2 | 42 +-
man2/ioctl_ns.2 | 28 +-
man2/ioctl_pipe.2 | 8 +-
man2/ioctl_tty.2 | 48 +-
man2/ioctl_userfaultfd.2 | 54 +--
man2/ioperm.2 | 14 +-
man2/iopl.2 | 12 +-
man2/ioprio_set.2 | 23 +-
man2/ipc.2 | 34 +-
man2/kcmp.2 | 42 +-
man2/kexec_load.2 | 12 +-
man2/keyctl.2 | 244 +++++-----
man2/kill.2 | 28 +-
man2/landlock_add_rule.2 | 16 +-
man2/landlock_create_ruleset.2 | 16 +-
man2/landlock_restrict_self.2 | 18 +-
man2/link.2 | 38 +-
man2/listen.2 | 26 +-
man2/listxattr.2 | 32 +-
man2/llseek.2 | 14 +-
man2/lookup_dcookie.2 | 6 +-
man2/lseek.2 | 20 +-
man2/madvise.2 | 68 +--
man2/mbind.2 | 42 +-
man2/membarrier.2 | 2 +-
man2/memfd_create.2 | 68 +--
man2/memfd_secret.2 | 38 +-
man2/migrate_pages.2 | 30 +-
man2/mincore.2 | 16 +-
man2/mkdir.2 | 30 +-
man2/mknod.2 | 40 +-
man2/mlock.2 | 46 +-
man2/mmap.2 | 82 ++--
man2/mmap2.2 | 20 +-
man2/modify_ldt.2 | 12 +-
man2/mount.2 | 74 +--
man2/mount_setattr.2 | 76 +--
man2/move_pages.2 | 28 +-
man2/mprotect.2 | 22 +-
man2/mq_getsetattr.2 | 10 +-
man2/mremap.2 | 38 +-
man2/msgctl.2 | 24 +-
man2/msgget.2 | 20 +-
man2/msgop.2 | 18 +-
man2/msync.2 | 8 +-
man2/nanosleep.2 | 36 +-
man2/nfsservctl.2 | 4 +-
man2/nice.2 | 28 +-
man2/open.2 | 320 ++++++-------
man2/open_by_handle_at.2 | 24 +-
man2/openat2.2 | 48 +-
man2/outb.2 | 8 +-
man2/pause.2 | 8 +-
man2/pciconfig_read.2 | 2 +-
man2/perf_event_open.2 | 100 ++--
man2/perfmonctl.2 | 14 +-
man2/personality.2 | 20 +-
man2/pidfd_getfd.2 | 26 +-
man2/pidfd_open.2 | 60 +--
man2/pidfd_send_signal.2 | 30 +-
man2/pipe.2 | 46 +-
man2/pivot_root.2 | 36 +-
man2/pkey_alloc.2 | 10 +-
man2/poll.2 | 42 +-
man2/posix_fadvise.2 | 26 +-
man2/prctl.2 | 259 ++++++-----
man2/pread.2 | 26 +-
man2/process_madvise.2 | 30 +-
man2/process_vm_readv.2 | 10 +-
man2/ptrace.2 | 277 +++++------
man2/query_module.2 | 14 +-
man2/quotactl.2 | 14 +-
man2/read.2 | 40 +-
man2/readahead.2 | 12 +-
man2/readdir.2 | 10 +-
man2/readlink.2 | 28 +-
man2/readv.2 | 40 +-
man2/reboot.2 | 36 +-
man2/recv.2 | 80 ++--
man2/recvmmsg.2 | 28 +-
man2/remap_file_pages.2 | 24 +-
man2/removexattr.2 | 26 +-
man2/rename.2 | 26 +-
man2/request_key.2 | 78 ++--
man2/restart_syscall.2 | 20 +-
man2/rmdir.2 | 18 +-
man2/rt_sigqueueinfo.2 | 38 +-
man2/s390_guarded_storage.2 | 4 +-
man2/s390_pci_mmio_write.2 | 4 +-
man2/s390_runtime_instr.2 | 6 +-
man2/s390_sthyi.2 | 4 +-
man2/sched_get_priority_max.2 | 16 +-
man2/sched_rr_get_interval.2 | 8 +-
man2/sched_setaffinity.2 | 72 +--
man2/sched_setattr.2 | 78 ++--
man2/sched_setparam.2 | 34 +-
man2/sched_setscheduler.2 | 56 +--
man2/sched_yield.2 | 2 +-
man2/seccomp.2 | 141 +++---
man2/seccomp_unotify.2 | 178 +++----
man2/select.2 | 66 +--
man2/select_tut.2 | 84 ++--
man2/semctl.2 | 32 +-
man2/semget.2 | 36 +-
man2/semop.2 | 34 +-
man2/send.2 | 78 ++--
man2/sendfile.2 | 26 +-
man2/sendmmsg.2 | 18 +-
man2/set_mempolicy.2 | 30 +-
man2/set_thread_area.2 | 18 +-
man2/set_tid_address.2 | 12 +-
man2/seteuid.2 | 20 +-
man2/setfsgid.2 | 14 +-
man2/setfsuid.2 | 16 +-
man2/setgid.2 | 14 +-
man2/setns.2 | 38 +-
man2/setpgid.2 | 42 +-
man2/setresuid.2 | 22 +-
man2/setreuid.2 | 24 +-
man2/setsid.2 | 24 +-
man2/setuid.2 | 22 +-
man2/setxattr.2 | 28 +-
man2/sgetmask.2 | 10 +-
man2/shmctl.2 | 35 +-
man2/shmget.2 | 32 +-
man2/shmop.2 | 24 +-
man2/shutdown.2 | 8 +-
man2/sigaction.2 | 136 +++---
man2/sigaltstack.2 | 32 +-
man2/signal.2 | 60 +--
man2/signalfd.2 | 130 +++---
man2/sigpending.2 | 24 +-
man2/sigprocmask.2 | 42 +-
man2/sigreturn.2 | 20 +-
man2/sigsuspend.2 | 30 +-
man2/sigwaitinfo.2 | 40 +-
man2/socket.2 | 120 ++---
man2/socketcall.2 | 84 ++--
man2/socketpair.2 | 16 +-
man2/splice.2 | 26 +-
man2/spu_create.2 | 28 +-
man2/spu_run.2 | 18 +-
man2/stat.2 | 38 +-
man2/statfs.2 | 36 +-
man2/statx.2 | 66 +--
man2/stime.2 | 10 +-
man2/subpage_prot.2 | 6 +-
man2/swapon.2 | 14 +-
man2/symlink.2 | 32 +-
man2/sync.2 | 10 +-
man2/sync_file_range.2 | 10 +-
man2/syscall.2 | 54 +--
man2/syscalls.2 | 128 ++---
man2/sysctl.2 | 4 +-
man2/sysfs.2 | 6 +-
man2/sysinfo.2 | 2 +-
man2/syslog.2 | 10 +-
man2/tee.2 | 18 +-
man2/time.2 | 16 +-
man2/timer_create.2 | 64 +--
man2/timer_delete.2 | 12 +-
man2/timer_getoverrun.2 | 26 +-
man2/timer_settime.2 | 20 +-
man2/timerfd_create.2 | 113 ++---
man2/times.2 | 22 +-
man2/tkill.2 | 16 +-
man2/truncate.2 | 24 +-
man2/umask.2 | 47 +-
man2/umount.2 | 14 +-
man2/uname.2 | 12 +-
man2/unimplemented.2 | 26 +-
man2/unlink.2 | 44 +-
man2/unshare.2 | 77 +--
man2/uselib.2 | 26 +-
man2/userfaultfd.2 | 106 ++---
man2/ustat.2 | 6 +-
man2/utime.2 | 20 +-
man2/utimensat.2 | 46 +-
man2/vfork.2 | 88 ++--
man2/vhangup.2 | 6 +-
man2/vmsplice.2 | 18 +-
man2/wait.2 | 80 ++--
man2/wait4.2 | 28 +-
man2/write.2 | 56 +--
man2type/open_how.2type | 4 +-
man3/CPU_SET.3 | 14 +-
man3/INFINITY.3 | 4 +-
man3/MAX.3 | 8 +-
man3/MB_CUR_MAX.3 | 12 +-
man3/MB_LEN_MAX.3 | 2 +-
man3/_Generic.3 | 2 +-
man3/__ppc_get_timebase.3 | 4 +-
man3/__ppc_set_ppr_med.3 | 4 +-
man3/__ppc_yield.3 | 4 +-
man3/__setfpucw.3 | 24 +-
man3/a64l.3 | 10 +-
man3/abort.3 | 24 +-
man3/abs.3 | 14 +-
man3/acos.3 | 20 +-
man3/acosh.3 | 18 +-
man3/addseverity.3 | 8 +-
man3/adjtime.3 | 14 +-
man3/aio_cancel.3 | 36 +-
man3/aio_error.3 | 32 +-
man3/aio_fsync.3 | 28 +-
man3/aio_init.3 | 2 +-
man3/aio_read.3 | 34 +-
man3/aio_return.3 | 32 +-
man3/aio_suspend.3 | 36 +-
man3/aio_write.3 | 32 +-
man3/alloca.3 | 24 +-
man3/arc4random.3 | 14 +-
man3/argz_add.3 | 8 +-
man3/asin.3 | 20 +-
man3/asinh.3 | 16 +-
man3/asprintf.3 | 16 +-
man3/assert.3 | 10 +-
man3/assert_perror.3 | 12 +-
man3/atan.3 | 20 +-
man3/atan2.3 | 18 +-
man3/atanh.3 | 18 +-
man3/atexit.3 | 36 +-
man3/atof.3 | 14 +-
man3/atoi.3 | 12 +-
man3/backtrace.3 | 24 +-
man3/basename.3 | 8 +-
man3/bcmp.3 | 4 +-
man3/bcopy.3 | 22 +-
man3/bindresvport.3 | 12 +-
man3/bsd_signal.3 | 28 +-
man3/bsearch.3 | 12 +-
man3/bstring.3 | 24 +-
man3/bswap.3 | 4 +-
man3/btowc.3 | 12 +-
man3/btree.3 | 18 +-
man3/byteorder.3 | 10 +-
man3/bzero.3 | 8 +-
man3/cabs.3 | 10 +-
man3/cacos.3 | 8 +-
man3/cacosh.3 | 12 +-
man3/canonicalize_file_name.3 | 10 +-
man3/carg.3 | 6 +-
man3/casin.3 | 8 +-
man3/casinh.3 | 12 +-
man3/catan.3 | 10 +-
man3/catanh.3 | 12 +-
man3/catgets.3 | 8 +-
man3/catopen.3 | 12 +-
man3/cbrt.3 | 8 +-
man3/ccos.3 | 12 +-
man3/ccosh.3 | 10 +-
man3/ceil.3 | 16 +-
man3/cexp.3 | 12 +-
man3/cexp2.3 | 8 +-
man3/cfree.3 | 22 +-
man3/cimag.3 | 8 +-
man3/circleq.3 | 4 +-
man3/clearenv.3 | 30 +-
man3/clock.3 | 16 +-
man3/clock_getcpuclockid.3 | 16 +-
man3/clog.3 | 14 +-
man3/clog10.3 | 12 +-
man3/clog2.3 | 10 +-
man3/closedir.3 | 16 +-
man3/cmsg.3 | 18 +-
man3/confstr.3 | 18 +-
man3/conj.3 | 8 +-
man3/copysign.3 | 6 +-
man3/cos.3 | 22 +-
man3/cosh.3 | 18 +-
man3/cpow.3 | 8 +-
man3/cproj.3 | 6 +-
man3/creal.3 | 8 +-
man3/crypt.3 | 24 +-
man3/csin.3 | 12 +-
man3/csinh.3 | 12 +-
man3/csqrt.3 | 8 +-
man3/ctan.3 | 12 +-
man3/ctanh.3 | 12 +-
man3/ctermid.3 | 6 +-
man3/ctime.3 | 40 +-
man3/daemon.3 | 26 +-
man3/dbopen.3 | 46 +-
man3/des_crypt.3 | 10 +-
man3/difftime.3 | 14 +-
man3/dirfd.3 | 28 +-
man3/div.3 | 8 +-
man3/dl_iterate_phdr.3 | 16 +-
man3/dladdr.3 | 16 +-
man3/dlerror.3 | 12 +-
man3/dlinfo.3 | 22 +-
man3/dlopen.3 | 50 +-
man3/dlsym.3 | 28 +-
man3/drand48.3 | 8 +-
man3/drand48_r.3 | 12 +-
man3/duplocale.3 | 28 +-
man3/dysize.3 | 6 +-
man3/ecvt.3 | 18 +-
man3/ecvt_r.3 | 24 +-
man3/encrypt.3 | 10 +-
man3/end.3 | 14 +-
man3/endian.3 | 10 +-
man3/envz_add.3 | 6 +-
man3/erf.3 | 12 +-
man3/erfc.3 | 12 +-
man3/err.3 | 16 +-
man3/errno.3 | 30 +-
man3/error.3 | 20 +-
man3/ether_aton.3 | 4 +-
man3/euidaccess.3 | 32 +-
man3/exec.3 | 32 +-
man3/exit.3 | 56 +--
man3/exp.3 | 18 +-
man3/exp10.3 | 18 +-
man3/exp2.3 | 20 +-
man3/expm1.3 | 12 +-
man3/fabs.3 | 16 +-
man3/fclose.3 | 26 +-
man3/fcloseall.3 | 14 +-
man3/fdim.3 | 8 +-
man3/fenv.3 | 4 +-
man3/ferror.3 | 22 +-
man3/fexecve.3 | 20 +-
man3/fflush.3 | 28 +-
man3/ffs.3 | 6 +-
man3/fgetc.3 | 38 +-
man3/fgetgrent.3 | 24 +-
man3/fgetpwent.3 | 26 +-
man3/fgetwc.3 | 16 +-
man3/fgetws.3 | 12 +-
man3/fileno.3 | 18 +-
man3/finite.3 | 8 +-
man3/flockfile.3 | 18 +-
man3/floor.3 | 16 +-
man3/fma.3 | 12 +-
man3/fmax.3 | 8 +-
man3/fmemopen.3 | 32 +-
man3/fmin.3 | 8 +-
man3/fmod.3 | 8 +-
man3/fmtmsg.3 | 8 +-
man3/fnmatch.3 | 14 +-
man3/fopen.3 | 49 +-
man3/fopencookie.3 | 20 +-
man3/fpathconf.3 | 16 +-
man3/fpclassify.3 | 12 +-
man3/fpurge.3 | 14 +-
man3/fputwc.3 | 14 +-
man3/fputws.3 | 12 +-
man3/fread.3 | 18 +-
man3/frexp.3 | 8 +-
man3/fseek.3 | 20 +-
man3/fseeko.3 | 14 +-
man3/ftime.3 | 14 +-
man3/ftok.3 | 22 +-
man3/fts.3 | 36 +-
man3/ftw.3 | 28 +-
man3/futimes.3 | 18 +-
man3/fwide.3 | 10 +-
man3/gamma.3 | 26 +-
man3/gcvt.3 | 16 +-
man3/get_nprocs.3 | 6 +-
man3/get_phys_pages.3 | 6 +-
man3/getaddrinfo.3 | 50 +-
man3/getaddrinfo_a.3 | 36 +-
man3/getauxval.3 | 22 +-
man3/getcontext.3 | 48 +-
man3/getcwd.3 | 34 +-
man3/getdate.3 | 26 +-
man3/getdirentries.3 | 12 +-
man3/getdtablesize.3 | 16 +-
man3/getentropy.3 | 14 +-
man3/getenv.3 | 24 +-
man3/getfsent.3 | 8 +-
man3/getgrent.3 | 28 +-
man3/getgrent_r.3 | 32 +-
man3/getgrnam.3 | 24 +-
man3/getgrouplist.3 | 18 +-
man3/gethostbyname.3 | 59 +--
man3/gethostid.3 | 14 +-
man3/getifaddrs.3 | 32 +-
man3/getipnodebyname.3 | 16 +-
man3/getline.3 | 18 +-
man3/getloadavg.3 | 8 +-
man3/getlogin.3 | 18 +-
man3/getmntent.3 | 16 +-
man3/getnameinfo.3 | 42 +-
man3/getnetent.3 | 8 +-
man3/getnetent_r.3 | 14 +-
man3/getopt.3 | 16 +-
man3/getpass.3 | 10 +-
man3/getprotoent.3 | 12 +-
man3/getprotoent_r.3 | 14 +-
man3/getpt.3 | 18 +-
man3/getpw.3 | 22 +-
man3/getpwent.3 | 28 +-
man3/getpwent_r.3 | 28 +-
man3/getpwnam.3 | 30 +-
man3/getrpcent.3 | 10 +-
man3/getrpcent_r.3 | 14 +-
man3/getrpcport.3 | 2 +-
man3/gets.3 | 36 +-
man3/getservent.3 | 12 +-
man3/getservent_r.3 | 14 +-
man3/getspnam.3 | 16 +-
man3/getsubopt.3 | 10 +-
man3/getttyent.3 | 6 +-
man3/getusershell.3 | 6 +-
man3/getutent.3 | 16 +-
man3/getutmp.3 | 8 +-
man3/getw.3 | 20 +-
man3/getwchar.3 | 10 +-
man3/glob.3 | 44 +-
man3/gnu_get_libc_version.3 | 4 +-
man3/grantpt.3 | 20 +-
man3/group_member.3 | 12 +-
man3/gsignal.3 | 18 +-
man3/hash.3 | 20 +-
man3/hsearch.3 | 12 +-
man3/hypot.3 | 10 +-
man3/iconv.3 | 10 +-
man3/iconv_close.3 | 8 +-
man3/iconv_open.3 | 16 +-
man3/if_nameindex.3 | 28 +-
man3/if_nametoindex.3 | 12 +-
man3/ilogb.3 | 14 +-
man3/index.3 | 16 +-
man3/inet.3 | 28 +-
man3/inet_net_pton.3 | 6 +-
man3/inet_ntop.3 | 14 +-
man3/inet_pton.3 | 20 +-
man3/initgroups.3 | 12 +-
man3/insque.3 | 6 +-
man3/intro.3 | 30 +-
man3/isalpha.3 | 46 +-
man3/isatty.3 | 6 +-
man3/isfdtype.3 | 10 +-
man3/isgreater.3 | 8 +-
man3/iswalnum.3 | 8 +-
man3/iswalpha.3 | 8 +-
man3/iswblank.3 | 10 +-
man3/iswcntrl.3 | 8 +-
man3/iswctype.3 | 30 +-
man3/iswdigit.3 | 8 +-
man3/iswgraph.3 | 8 +-
man3/iswlower.3 | 10 +-
man3/iswprint.3 | 8 +-
man3/iswpunct.3 | 8 +-
man3/iswspace.3 | 8 +-
man3/iswupper.3 | 10 +-
man3/iswxdigit.3 | 8 +-
man3/j0.3 | 10 +-
man3/key_setsecret.3 | 4 +-
man3/killpg.3 | 20 +-
man3/ldexp.3 | 12 +-
man3/lgamma.3 | 8 +-
man3/lio_listio.3 | 40 +-
man3/list.3 | 4 +-
man3/localeconv.3 | 26 +-
man3/lockf.3 | 14 +-
man3/log.3 | 18 +-
man3/log10.3 | 22 +-
man3/log1p.3 | 12 +-
man3/log2.3 | 20 +-
man3/logb.3 | 10 +-
man3/login.3 | 14 +-
man3/lrint.3 | 22 +-
man3/lround.3 | 24 +-
man3/lsearch.3 | 8 +-
man3/lseek64.3 | 14 +-
man3/makecontext.3 | 26 +-
man3/makedev.3 | 10 +-
man3/mallinfo.3 | 38 +-
man3/malloc.3 | 50 +-
man3/malloc_get_state.3 | 20 +-
man3/malloc_hook.3 | 26 +-
man3/malloc_info.3 | 20 +-
man3/malloc_stats.3 | 20 +-
man3/malloc_trim.3 | 16 +-
man3/malloc_usable_size.3 | 8 +-
man3/mallopt.3 | 68 +--
man3/matherr.3 | 18 +-
man3/mblen.3 | 6 +-
man3/mbrlen.3 | 4 +-
man3/mbrtowc.3 | 6 +-
man3/mbsinit.3 | 18 +-
man3/mbsnrtowcs.3 | 14 +-
man3/mbsrtowcs.3 | 12 +-
man3/mbstowcs.3 | 14 +-
man3/mbtowc.3 | 16 +-
man3/mcheck.3 | 16 +-
man3/memccpy.3 | 14 +-
man3/memchr.3 | 28 +-
man3/memcmp.3 | 16 +-
man3/memcpy.3 | 22 +-
man3/memfrob.3 | 6 +-
man3/memmem.3 | 6 +-
man3/memmove.3 | 16 +-
man3/mempcpy.3 | 12 +-
man3/memset.3 | 10 +-
man3/mkdtemp.3 | 20 +-
man3/mkfifo.3 | 26 +-
man3/mkstemp.3 | 24 +-
man3/mktemp.3 | 20 +-
man3/modf.3 | 8 +-
man3/mpool.3 | 20 +-
man3/mq_close.3 | 20 +-
man3/mq_getattr.3 | 30 +-
man3/mq_notify.3 | 30 +-
man3/mq_open.3 | 36 +-
man3/mq_receive.3 | 28 +-
man3/mq_send.3 | 28 +-
man3/mq_unlink.3 | 16 +-
man3/mtrace.3 | 31 +-
man3/nan.3 | 14 +-
man3/netlink.3 | 6 +-
man3/newlocale.3 | 26 +-
man3/nextafter.3 | 8 +-
man3/nextup.3 | 6 +-
man3/nl_langinfo.3 | 62 +--
man3/ntp_gettime.3 | 14 +-
man3/offsetof.3 | 2 +-
man3/on_exit.3 | 20 +-
man3/open_memstream.3 | 28 +-
man3/opendir.3 | 24 +-
man3/openpty.3 | 14 +-
man3/perror.3 | 14 +-
man3/popen.3 | 42 +-
man3/posix_fallocate.3 | 18 +-
man3/posix_madvise.3 | 10 +-
man3/posix_memalign.3 | 26 +-
man3/posix_openpt.3 | 24 +-
man3/posix_spawn.3 | 170 +++----
man3/pow.3 | 12 +-
man3/pow10.3 | 8 +-
man3/powerof2.3 | 4 +-
man3/printf.3 | 46 +-
man3/profil.3 | 16 +-
man3/program_invocation_name.3 | 2 +-
man3/psignal.3 | 16 +-
man3/pthread_atfork.3 | 28 +-
man3/pthread_attr_init.3 | 40 +-
man3/pthread_attr_setaffinity_np.3 | 16 +-
man3/pthread_attr_setdetachstate.3 | 26 +-
man3/pthread_attr_setguardsize.3 | 26 +-
man3/pthread_attr_setinheritsched.3 | 35 +-
man3/pthread_attr_setschedparam.3 | 30 +-
man3/pthread_attr_setschedpolicy.3 | 26 +-
man3/pthread_attr_setscope.3 | 20 +-
man3/pthread_attr_setsigmask_np.3 | 20 +-
man3/pthread_attr_setstack.3 | 32 +-
man3/pthread_attr_setstackaddr.3 | 20 +-
man3/pthread_attr_setstacksize.3 | 20 +-
man3/pthread_cancel.3 | 34 +-
man3/pthread_cleanup_push.3 | 34 +-
man3/pthread_cleanup_push_defer_np.3 | 24 +-
man3/pthread_create.3 | 72 +--
man3/pthread_detach.3 | 24 +-
man3/pthread_equal.3 | 8 +-
man3/pthread_exit.3 | 22 +-
man3/pthread_getattr_default_np.3 | 30 +-
man3/pthread_getattr_np.3 | 36 +-
man3/pthread_getcpuclockid.3 | 22 +-
man3/pthread_join.3 | 18 +-
man3/pthread_kill.3 | 22 +-
man3/pthread_kill_other_threads_np.3 | 18 +-
man3/pthread_mutex_consistent.3 | 14 +-
man3/pthread_mutexattr_getpshared.3 | 4 +-
man3/pthread_mutexattr_init.3 | 8 +-
man3/pthread_mutexattr_setrobust.3 | 34 +-
man3/pthread_rwlockattr_setkind_np.3 | 4 +-
man3/pthread_self.3 | 14 +-
man3/pthread_setaffinity_np.3 | 34 +-
man3/pthread_setcancelstate.3 | 22 +-
man3/pthread_setconcurrency.3 | 6 +-
man3/pthread_setname_np.3 | 10 +-
man3/pthread_setschedparam.3 | 40 +-
man3/pthread_setschedprio.3 | 30 +-
man3/pthread_sigmask.3 | 32 +-
man3/pthread_sigqueue.3 | 26 +-
man3/pthread_spin_init.3 | 16 +-
man3/pthread_spin_lock.3 | 12 +-
man3/pthread_testcancel.3 | 14 +-
man3/pthread_tryjoin_np.3 | 22 +-
man3/pthread_yield.3 | 14 +-
man3/ptsname.3 | 18 +-
man3/putenv.3 | 14 +-
man3/putgrent.3 | 10 +-
man3/putpwent.3 | 18 +-
man3/puts.3 | 28 +-
man3/putwchar.3 | 10 +-
man3/qecvt.3 | 24 +-
man3/qsort.3 | 16 +-
man3/raise.3 | 18 +-
man3/rand.3 | 16 +-
man3/random.3 | 16 +-
man3/random_r.3 | 22 +-
man3/rcmd.3 | 24 +-
man3/re_comp.3 | 8 +-
man3/readdir.3 | 38 +-
man3/readdir_r.3 | 22 +-
man3/realpath.3 | 30 +-
man3/recno.3 | 26 +-
man3/regex.3 | 8 +-
man3/remainder.3 | 14 +-
man3/remove.3 | 30 +-
man3/remquo.3 | 16 +-
man3/resolver.3 | 24 +-
man3/rewinddir.3 | 14 +-
man3/rexec.3 | 16 +-
man3/rint.3 | 20 +-
man3/round.3 | 22 +-
man3/roundup.3 | 12 +-
man3/rpc.3 | 14 +-
man3/rpmatch.3 | 24 +-
man3/rtime.3 | 17 +-
man3/rtnetlink.3 | 10 +-
man3/scalb.3 | 16 +-
man3/scalbln.3 | 16 +-
man3/scandir.3 | 40 +-
man3/scanf.3 | 30 +-
man3/sched_getcpu.3 | 12 +-
man3/seekdir.3 | 24 +-
man3/sem_close.3 | 16 +-
man3/sem_destroy.3 | 16 +-
man3/sem_getvalue.3 | 12 +-
man3/sem_init.3 | 28 +-
man3/sem_open.3 | 18 +-
man3/sem_post.3 | 16 +-
man3/sem_unlink.3 | 12 +-
man3/sem_wait.3 | 22 +-
man3/setaliasent.3 | 10 +-
man3/setbuf.3 | 24 +-
man3/setenv.3 | 14 +-
man3/setjmp.3 | 10 +-
man3/setlocale.3 | 36 +-
man3/setlogmask.3 | 10 +-
man3/setnetgrent.3 | 10 +-
man3/shm_open.3 | 48 +-
man3/siginterrupt.3 | 8 +-
man3/signbit.3 | 6 +-
man3/significand.3 | 8 +-
man3/sigpause.3 | 22 +-
man3/sigqueue.3 | 34 +-
man3/sigset.3 | 53 +--
man3/sigsetops.3 | 14 +-
man3/sigvec.3 | 43 +-
man3/sigwait.3 | 26 +-
man3/sin.3 | 22 +-
man3/sincos.3 | 16 +-
man3/sinh.3 | 18 +-
man3/sleep.3 | 22 +-
man3/slist.3 | 4 +-
man3/sockatmark.3 | 16 +-
man3/sqrt.3 | 12 +-
man3/sscanf.3 | 32 +-
man3/stailq.3 | 4 +-
man3/static_assert.3 | 4 +-
man3/statvfs.3 | 26 +-
man3/stdarg.3 | 10 +-
man3/stdin.3 | 46 +-
man3/stdio.3 | 24 +-
man3/stdio_ext.3 | 8 +-
man3/stpncpy.3 | 10 +-
man3/strcasecmp.3 | 16 +-
man3/strchr.3 | 22 +-
man3/strcmp.3 | 24 +-
man3/strcoll.3 | 18 +-
man3/strcpy.3 | 14 +-
man3/strdup.3 | 24 +-
man3/strerror.3 | 18 +-
man3/strfmon.3 | 12 +-
man3/strfromd.3 | 12 +-
man3/strfry.3 | 6 +-
man3/strftime.3 | 48 +-
man3/string.3 | 52 +--
man3/strlen.3 | 12 +-
man3/strncat.3 | 10 +-
man3/strnlen.3 | 6 +-
man3/strpbrk.3 | 18 +-
man3/strptime.3 | 24 +-
man3/strsep.3 | 24 +-
man3/strsignal.3 | 8 +-
man3/strspn.3 | 20 +-
man3/strstr.3 | 22 +-
man3/strtod.3 | 26 +-
man3/strtoimax.3 | 16 +-
man3/strtok.3 | 22 +-
man3/strtol.3 | 20 +-
man3/strtoul.3 | 22 +-
man3/strverscmp.3 | 20 +-
man3/strxfrm.3 | 20 +-
man3/swab.3 | 4 +-
man3/sysconf.3 | 52 +--
man3/syslog.3 | 26 +-
man3/system.3 | 52 +--
man3/sysv_signal.3 | 22 +-
man3/tailq.3 | 4 +-
man3/tan.3 | 20 +-
man3/tanh.3 | 16 +-
man3/tcgetpgrp.3 | 8 +-
man3/tcgetsid.3 | 6 +-
man3/telldir.3 | 18 +-
man3/tempnam.3 | 30 +-
man3/termios.3 | 74 +--
man3/tgamma.3 | 14 +-
man3/timegm.3 | 18 +-
man3/timeradd.3 | 6 +-
man3/tmpfile.3 | 14 +-
man3/tmpnam.3 | 28 +-
man3/toascii.3 | 10 +-
man3/toupper.3 | 20 +-
man3/towctrans.3 | 10 +-
man3/towlower.3 | 16 +-
man3/towupper.3 | 16 +-
man3/trunc.3 | 16 +-
man3/tsearch.3 | 10 +-
man3/ttyname.3 | 14 +-
man3/ttyslot.3 | 20 +-
man3/tzset.3 | 22 +-
man3/ualarm.3 | 45 +-
man3/ulimit.3 | 18 +-
man3/undocumented.3 | 264 +++++------
man3/ungetwc.3 | 6 +-
man3/unlocked_stdio.3 | 10 +-
man3/unlockpt.3 | 14 +-
man3/updwtmp.3 | 8 +-
man3/uselocale.3 | 28 +-
man3/usleep.3 | 46 +-
man3/wcpcpy.3 | 10 +-
man3/wcpncpy.3 | 10 +-
man3/wcrtomb.3 | 6 +-
man3/wcscasecmp.3 | 15 +-
man3/wcscat.3 | 12 +-
man3/wcschr.3 | 14 +-
man3/wcscmp.3 | 10 +-
man3/wcscpy.3 | 14 +-
man3/wcscspn.3 | 10 +-
man3/wcsdup.3 | 14 +-
man3/wcslen.3 | 8 +-
man3/wcsncasecmp.3 | 15 +-
man3/wcsncat.3 | 8 +-
man3/wcsncmp.3 | 8 +-
man3/wcsncpy.3 | 6 +-
man3/wcsnlen.3 | 10 +-
man3/wcsnrtombs.3 | 12 +-
man3/wcspbrk.3 | 10 +-
man3/wcsrchr.3 | 8 +-
man3/wcsrtombs.3 | 12 +-
man3/wcsspn.3 | 8 +-
man3/wcsstr.3 | 8 +-
man3/wcstoimax.3 | 18 +-
man3/wcstok.3 | 8 +-
man3/wcstombs.3 | 14 +-
man3/wcswidth.3 | 6 +-
man3/wctob.3 | 12 +-
man3/wctomb.3 | 16 +-
man3/wctrans.3 | 6 +-
man3/wctype.3 | 6 +-
man3/wcwidth.3 | 6 +-
man3/wmemchr.3 | 8 +-
man3/wmemcmp.3 | 8 +-
man3/wmemcpy.3 | 14 +-
man3/wmemmove.3 | 8 +-
man3/wmemset.3 | 6 +-
man3/wordexp.3 | 16 +-
man3/wprintf.3 | 48 +-
man3/xcrypt.3 | 4 +-
man3/xdr.3 | 12 +-
man3/y0.3 | 10 +-
man3const/EOF.3const | 4 +-
man3const/EXIT_SUCCESS.3const | 6 +-
man3const/NULL.3const | 8 +-
man3head/printf.h.3head | 22 +-
man3head/sysexits.h.3head | 12 +-
man3type/FILE.3type | 16 +-
man3type/aiocb.3type | 18 +-
man3type/blkcnt_t.3type | 2 +-
man3type/blksize_t.3type | 2 +-
man3type/cc_t.3type | 2 +-
man3type/clock_t.3type | 4 +-
man3type/clockid_t.3type | 10 +-
man3type/dev_t.3type | 6 +-
man3type/div_t.3type | 10 +-
man3type/epoll_event.3type | 4 +-
man3type/fenv_t.3type | 4 +-
man3type/id_t.3type | 46 +-
man3type/intN_t.3type | 10 +-
man3type/intmax_t.3type | 12 +-
man3type/intptr_t.3type | 8 +-
man3type/iovec.3type | 4 +-
man3type/itimerspec.3type | 6 +-
man3type/lconv.3type | 8 +-
man3type/mode_t.3type | 10 +-
man3type/off_t.3type | 28 +-
man3type/ptrdiff_t.3type | 6 +-
man3type/size_t.3type | 34 +-
man3type/sockaddr.3type | 34 +-
man3type/stat.3type | 14 +-
man3type/time_t.3type | 12 +-
man3type/timer_t.3type | 10 +-
man3type/timespec.3type | 14 +-
man3type/timeval.3type | 18 +-
man3type/tm.3type | 20 +-
man3type/va_list.3type | 16 +-
man3type/void.3type | 14 +-
man4/cciss.4 | 18 +-
man4/console_codes.4 | 30 +-
man4/cpuid.4 | 6 +-
man4/dsp56k.4 | 10 +-
man4/fd.4 | 18 +-
man4/full.4 | 6 +-
man4/fuse.4 | 28 +-
man4/hd.4 | 8 +-
man4/hpsa.4 | 33 +-
man4/initrd.4 | 16 +-
man4/intro.4 | 6 +-
man4/lirc.4 | 16 +-
man4/loop.4 | 32 +-
man4/lp.4 | 16 +-
man4/mem.4 | 6 +-
man4/mouse.4 | 6 +-
man4/null.4 | 8 +-
man4/pts.4 | 24 +-
man4/ram.4 | 6 +-
man4/random.4 | 34 +-
man4/rtc.4 | 56 +--
man4/sd.4 | 16 +-
man4/sk98lin.4 | 12 +-
man4/smartpqi.4 | 14 +-
man4/st.4 | 28 +-
man4/tty.4 | 28 +-
man4/ttyS.4 | 12 +-
man4/vcs.4 | 18 +-
man4/veth.4 | 12 +-
man4/wavelan.4 | 22 +-
man5/acct.5 | 12 +-
man5/charmap.5 | 12 +-
man5/core.5 | 97 ++--
man5/dir_colors.5 | 18 +-
man5/elf.5 | 38 +-
man5/erofs.5 | 12 +-
man5/filesystems.5 | 46 +-
man5/ftpusers.5 | 6 +-
man5/gai.conf.5 | 4 +-
man5/group.5 | 24 +-
man5/host.conf.5 | 18 +-
man5/hosts.5 | 14 +-
man5/hosts.equiv.5 | 6 +-
man5/intro.5 | 2 +-
man5/issue.5 | 6 +-
man5/locale.5 | 58 +--
man5/motd.5 | 6 +-
man5/networks.5 | 16 +-
man5/nologin.5 | 6 +-
man5/nscd.conf.5 | 10 +-
man5/nss.5 | 18 +-
man5/nsswitch.conf.5 | 32 +-
man5/passwd.5 | 48 +-
man5/proc.5 | 668 ++++++++++++++-------------
man5/protocols.5 | 2 +-
man5/repertoiremap.5 | 10 +-
man5/resolv.conf.5 | 36 +-
man5/rpc.5 | 2 +-
man5/securetty.5 | 12 +-
man5/services.5 | 48 +-
man5/shells.5 | 8 +-
man5/slabinfo.5 | 2 +-
man5/sysfs.5 | 12 +-
man5/termcap.5 | 10 +-
man5/tmpfs.5 | 37 +-
man5/ttytype.5 | 14 +-
man5/tzfile.5 | 24 +-
man5/utmp.5 | 78 ++--
man7/address_families.7 | 38 +-
man7/aio.7 | 76 +--
man7/armscii-8.7 | 8 +-
man7/arp.7 | 16 +-
man7/ascii.7 | 34 +-
man7/attributes.7 | 20 +-
man7/boot.7 | 34 +-
man7/bootparam.7 | 22 +-
man7/capabilities.7 | 413 +++++++++--------
man7/cgroup_namespaces.7 | 34 +-
man7/cgroups.7 | 74 +--
man7/charsets.7 | 14 +-
man7/complex.7 | 52 +--
man7/cp1251.7 | 16 +-
man7/cp1252.7 | 14 +-
man7/cpuset.7 | 158 +++----
man7/credentials.7 | 259 ++++++-----
man7/ddp.7 | 20 +-
man7/environ.7 | 110 ++---
man7/epoll.7 | 117 ++---
man7/fanotify.7 | 116 ++---
man7/feature_test_macros.7 | 58 +--
man7/fifo.7 | 20 +-
man7/futex.7 | 24 +-
man7/glob.7 | 12 +-
man7/hier.7 | 28 +-
man7/hostname.7 | 20 +-
man7/icmp.7 | 8 +-
man7/inode.7 | 72 +--
man7/inotify.7 | 142 +++---
man7/intro.7 | 2 +-
man7/ip.7 | 171 +++----
man7/ipc_namespaces.7 | 20 +-
man7/ipv6.7 | 28 +-
man7/iso_8859-1.7 | 12 +-
man7/iso_8859-10.7 | 8 +-
man7/iso_8859-11.7 | 8 +-
man7/iso_8859-13.7 | 8 +-
man7/iso_8859-14.7 | 8 +-
man7/iso_8859-15.7 | 12 +-
man7/iso_8859-16.7 | 10 +-
man7/iso_8859-2.7 | 12 +-
man7/iso_8859-3.7 | 8 +-
man7/iso_8859-4.7 | 8 +-
man7/iso_8859-5.7 | 14 +-
man7/iso_8859-6.7 | 8 +-
man7/iso_8859-7.7 | 8 +-
man7/iso_8859-8.7 | 8 +-
man7/iso_8859-9.7 | 8 +-
man7/keyrings.7 | 152 +++---
man7/koi8-r.7 | 14 +-
man7/koi8-u.7 | 14 +-
man7/landlock.7 | 86 ++--
man7/libc.7 | 14 +-
man7/locale.7 | 127 ++---
man7/mailaddr.7 | 8 +-
man7/man-pages.7 | 50 +-
man7/man.7 | 42 +-
man7/math_error.7 | 38 +-
man7/mount_namespaces.7 | 155 ++++---
man7/mq_overview.7 | 94 ++--
man7/namespaces.7 | 99 ++--
man7/netdevice.7 | 20 +-
man7/netlink.7 | 32 +-
man7/network_namespaces.7 | 37 +-
man7/nptl.7 | 50 +-
man7/numa.7 | 26 +-
man7/packet.7 | 54 +--
man7/path_resolution.7 | 40 +-
man7/persistent-keyring.7 | 52 +--
man7/pid_namespaces.7 | 108 ++---
man7/pipe.7 | 94 ++--
man7/pkeys.7 | 34 +-
man7/posixoptions.7 | 18 +-
man7/process-keyring.7 | 26 +-
man7/pthreads.7 | 175 +++----
man7/pty.7 | 56 +--
man7/queue.7 | 12 +-
man7/random.7 | 26 +-
man7/raw.7 | 41 +-
man7/regex.7 | 8 +-
man7/rtld-audit.7 | 18 +-
man7/rtnetlink.7 | 14 +-
man7/sched.7 | 190 ++++----
man7/sem_overview.7 | 61 +--
man7/session-keyring.7 | 54 +--
man7/shm_overview.7 | 58 +--
man7/sigevent.7 | 26 +-
man7/signal-safety.7 | 38 +-
man7/signal.7 | 372 +++++++--------
man7/sock_diag.7 | 26 +-
man7/socket.7 | 264 +++++------
man7/spufs.7 | 140 +++---
man7/standards.7 | 18 +-
man7/string_copying.7 | 176 +++----
man7/suffixes.7 | 6 +-
man7/symlink.7 | 174 +++----
man7/system_data_types.7 | 56 +--
man7/sysvipc.7 | 66 +--
man7/tcp.7 | 136 +++---
man7/termio.7 | 22 +-
man7/thread-keyring.7 | 26 +-
man7/time.7 | 124 ++---
man7/time_namespaces.7 | 48 +-
man7/udp.7 | 68 +--
man7/udplite.7 | 26 +-
man7/unicode.7 | 14 +-
man7/unix.7 | 166 +++----
man7/uri.7 | 20 +-
man7/user-keyring.7 | 44 +-
man7/user-session-keyring.7 | 44 +-
man7/user_namespaces.7 | 226 ++++-----
man7/utf-8.7 | 14 +-
man7/uts_namespaces.7 | 32 +-
man7/vdso.7 | 22 +-
man7/vsock.7 | 40 +-
man7/x25.7 | 12 +-
man7/xattr.7 | 40 +-
man8/iconvconfig.8 | 8 +-
man8/intro.8 | 2 +-
man8/ld.so.8 | 53 +--
man8/ldconfig.8 | 4 +-
man8/nscd.8 | 28 +-
man8/sln.8 | 8 +-
man8/zdump.8 | 12 +-
man8/zic.8 | 6 +-
1100 files changed, 15657 insertions(+), 15493 deletions(-)
diff --git a/man1/getent.1 b/man1/getent.1
index e9c5efb8a..4c9b419da 100644
--- a/man1/getent.1
+++ b/man1/getent.1
@@ -35,10 +35,10 @@ .SH DESCRIPTION
When no
.I key
is provided, use
-.BR sethostent (3),
-.BR gethostent (3),
+.MR sethostent 3 ,
+.MR gethostent 3 ,
and
-.BR endhostent (3)
+.MR endhostent 3
to enumerate the hosts database.
This is identical to using
.BR hosts .
@@ -47,7 +47,7 @@ .SH DESCRIPTION
arguments are provided, pass each
.I key
in succession to
-.BR getaddrinfo (3)
+.MR getaddrinfo 3
with the address family
.BR AF_UNSPEC ,
enumerating each socket address structure returned.
@@ -64,7 +64,7 @@ .SH DESCRIPTION
but use the address family
.BR AF_INET6 .
The call to
-.BR getaddrinfo (3)
+.MR getaddrinfo 3
in this case includes the
.B AI_V4MAPPED
flag.
@@ -73,17 +73,17 @@ .SH DESCRIPTION
When no
.I key
is provided, use
-.BR setaliasent (3),
-.BR getaliasent (3),
+.MR setaliasent 3 ,
+.MR getaliasent 3 ,
and
-.BR endaliasent (3)
+.MR endaliasent 3
to enumerate the aliases database.
When one or more
.I key
arguments are provided, pass each
.I key
in succession to
-.BR getaliasbyname (3)
+.MR getaliasbyname 3
and display the result.
.TP
.B ethers
@@ -92,9 +92,9 @@ .SH DESCRIPTION
arguments are provided, pass each
.I key
in succession to
-.BR ether_aton (3)
+.MR ether_aton 3
and
-.BR ether_hostton (3)
+.MR ether_hostton 3
until a result is obtained, and display the result.
Enumeration is not supported on
.BR ethers ,
@@ -106,59 +106,59 @@ .SH DESCRIPTION
When no
.I key
is provided, use
-.BR setgrent (3),
-.BR getgrent (3),
+.MR setgrent 3 ,
+.MR getgrent 3 ,
and
-.BR endgrent (3)
+.MR endgrent 3
to enumerate the group database.
When one or more
.I key
arguments are provided, pass each numeric
.I key
to
-.BR getgrgid (3)
+.MR getgrgid 3
and each nonnumeric
.I key
to
-.BR getgrnam (3)
+.MR getgrnam 3
and display the result.
.TP
.B gshadow
When no
.I key
is provided, use
-.BR setsgent (3),
-.BR getsgent (3),
+.MR setsgent 3 ,
+.MR getsgent 3 ,
and
-.BR endsgent (3)
+.MR endsgent 3
to enumerate the gshadow database.
When one or more
.I key
arguments are provided, pass each
.I key
in succession to
-.BR getsgnam (3)
+.MR getsgnam 3
and display the result.
.TP
.B hosts
When no
.I key
is provided, use
-.BR sethostent (3),
-.BR gethostent (3),
+.MR sethostent 3 ,
+.MR gethostent 3 ,
and
-.BR endhostent (3)
+.MR endhostent 3
to enumerate the hosts database.
When one or more
.I key
arguments are provided, pass each
.I key
to
-.BR gethostbyaddr (3)
+.MR gethostbyaddr 3
or
-.BR gethostbyname2 (3),
+.MR gethostbyname2 3 ,
depending on whether a call to
-.BR inet_pton (3)
+.MR inet_pton 3
indicates that the
.I key
is an IPv6 or IPv4 address or not, and display the result.
@@ -169,7 +169,7 @@ .SH DESCRIPTION
arguments are provided, pass each
.I key
in succession to
-.BR getgrouplist (3)
+.MR getgrouplist 3
and display the result.
Enumeration is not supported on
.BR initgroups ,
@@ -183,9 +183,9 @@ .SH DESCRIPTION
is provided, pass the
.I key
to
-.BR setnetgrent (3)
+.MR setnetgrent 3
and, using
-.BR getnetgrent (3)
+.MR getnetgrent 3
display the resulting string triple
.RI ( hostname ", " username ", " domainname ).
Alternatively, three
@@ -196,7 +196,7 @@ .SH DESCRIPTION
and
.I domainname
to match to a netgroup name via
-.BR innetgr (3).
+.MR innetgr 3 .
Enumeration is not supported on
.BR netgroup ,
so either one or three
@@ -207,122 +207,122 @@ .SH DESCRIPTION
When no
.I key
is provided, use
-.BR setnetent (3),
-.BR getnetent (3),
+.MR setnetent 3 ,
+.MR getnetent 3 ,
and
-.BR endnetent (3)
+.MR endnetent 3
to enumerate the networks database.
When one or more
.I key
arguments are provided, pass each numeric
.I key
to
-.BR getnetbyaddr (3)
+.MR getnetbyaddr 3
and each nonnumeric
.I key
to
-.BR getnetbyname (3)
+.MR getnetbyname 3
and display the result.
.TP
.B passwd
When no
.I key
is provided, use
-.BR setpwent (3),
-.BR getpwent (3),
+.MR setpwent 3 ,
+.MR getpwent 3 ,
and
-.BR endpwent (3)
+.MR endpwent 3
to enumerate the passwd database.
When one or more
.I key
arguments are provided, pass each numeric
.I key
to
-.BR getpwuid (3)
+.MR getpwuid 3
and each nonnumeric
.I key
to
-.BR getpwnam (3)
+.MR getpwnam 3
and display the result.
.TP
.B protocols
When no
.I key
is provided, use
-.BR setprotoent (3),
-.BR getprotoent (3),
+.MR setprotoent 3 ,
+.MR getprotoent 3 ,
and
-.BR endprotoent (3)
+.MR endprotoent 3
to enumerate the protocols database.
When one or more
.I key
arguments are provided, pass each numeric
.I key
to
-.BR getprotobynumber (3)
+.MR getprotobynumber 3
and each nonnumeric
.I key
to
-.BR getprotobyname (3)
+.MR getprotobyname 3
and display the result.
.TP
.B rpc
When no
.I key
is provided, use
-.BR setrpcent (3),
-.BR getrpcent (3),
+.MR setrpcent 3 ,
+.MR getrpcent 3 ,
and
-.BR endrpcent (3)
+.MR endrpcent 3
to enumerate the rpc database.
When one or more
.I key
arguments are provided, pass each numeric
.I key
to
-.BR getrpcbynumber (3)
+.MR getrpcbynumber 3
and each nonnumeric
.I key
to
-.BR getrpcbyname (3)
+.MR getrpcbyname 3
and display the result.
.TP
.B services
When no
.I key
is provided, use
-.BR setservent (3),
-.BR getservent (3),
+.MR setservent 3 ,
+.MR getservent 3 ,
and
-.BR endservent (3)
+.MR endservent 3
to enumerate the services database.
When one or more
.I key
arguments are provided, pass each numeric
.I key
to
-.BR getservbynumber (3)
+.MR getservbynumber 3
and each nonnumeric
.I key
to
-.BR getservbyname (3)
+.MR getservbyname 3
and display the result.
.TP
.B shadow
When no
.I key
is provided, use
-.BR setspent (3),
-.BR getspent (3),
+.MR setspent 3 ,
+.MR getspent 3 ,
and
-.BR endspent (3)
+.MR endspent 3
to enumerate the shadow database.
When one or more
.I key
arguments are provided, pass each
.I key
in succession to
-.BR getspnam (3)
+.MR getspnam 3
and display the result.
.RE
.SH OPTIONS
@@ -379,4 +379,4 @@ .SH EXIT STATUS
.IR database .
.RE
.SH SEE ALSO
-.BR nsswitch.conf (5)
+.MR nsswitch.conf 5
[DIFF TRUNCATED DUE TO IMMENSE SIZE AND VGER RESTRICTIONS]
--
2.30.2
v2: Handle leading punctuation case in sed script. Also handle man
pages with '.' in their names.
v1 never made it too the mailing list because it was too big.
Regards,
Branden
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]
^ permalink raw reply related [flat|nested] 17+ messages in thread* Re: [PATCH v2] man*/: ffix (migrate to `MR`) 2023-07-31 17:52 [PATCH v2] man*/: ffix (migrate to `MR`) G. Branden Robinson @ 2023-07-31 21:47 ` Alejandro Colomar 2023-07-31 22:50 ` G. Branden Robinson 2023-07-31 22:16 ` Jakub Wilk 1 sibling, 1 reply; 17+ messages in thread From: Alejandro Colomar @ 2023-07-31 21:47 UTC (permalink / raw) To: G. Branden Robinson; +Cc: linux-man [-- Attachment #1.1: Type: text/plain, Size: 68158 bytes --] Hi Branden! On 2023-07-31 19:52, G. Branden Robinson wrote: > Use the man(7) macro `MR`, new to groff 1.23.0, instead of font style > alternation macros to mark up man page cross reference. > > Background (from the groff 1.23.0 release announcement and "NEWS" file): > > o The an (man) macro package supports a new macro, `MR`, intended for > use by man page cross references in preference to the font style > alternation macros historically used. Where before you would write > .BR ls (1). > or > .IR ls (1). > you should now write > .MR ls 1 . > (the third argument, typically used for trailing punctuation, is > optional). Because the macro semantically identifies a man page, it > can create a clickable hyperlink ("man:ls(1)" for the above example) > on supporting devices. Furthermore, a new string, `MF`, defines the > font to be used for setting the man page topic (the first argument to > `MR` and `TH`), permitting configuration by distributions, sites, and > users. > > Inclusion of the `MR` macro was prompted by its introduction to > Plan 9 from User Space's troff in August 2020. Its purpose is to > ameliorate several long-standing problems with man page cross > references: (1) the package's lack of inherent hyperlink support for > them; (2) false-positive identification of strings resembling man page > cross references (as can happen with "exit(1)", "while(1)", > "sleep(5)", "time(0)" and others) by terminal emulators and other > programs; (3) the unwanted intrusion of hyphens into man page topics, > which frustrates copy-and-paste operations (this problem has always > been avoidable through use of the \% escape sequence, but cross > references are frequent in man pages and some page authors are > inexpert *roff users); and (4) deep divisions in man page maintenance > communities over which typeface should be used to set the man page > topic (italics, roman, or bold). > [...] > o The an (man) macro package can now produce clickable hyperlinks within > terminal emulators, using the OSC 8 support added to grotty(1) (see > below). The groff man(7) extension macros `UR` and `MT`, present > since 2007, expose this feature. At present the feature is disabled > by default in `man.local` pending more widespread recognition of OSC 8 > sequences in pager programs. The package now recognizes a `U` > register to enable hyperlinks in any output driver supporting them. > > Use a command like > printf '\033]8;;man:grotty(1)\033\\grotty(1)\033]8;;\033\\\n' | more > to check your terminal and pager for OSC 8 support. If you see > "grotty(1)" and no additional garbage characters, then you may wish to > edit "man.local" to remove the lines that disable this feature. > > When the text of all Linux man-pages documents (excluding those > containing only `so` requests) is dumped, with adjustment mode 'l' > ("-dAD=l") and automatic hyphenation disabled ("-rHY=0") before and > after this change, there is no change to rendered output. It would be interesting to see a script that corroborates the above paragraph. It might help other projects that may want to migrate to MR. > > When automatic hyphenation is enabled, this change suppresses > hyphenation of approximately 3,100+ man page names when cross referenced > when using the default terminal width of 80 (meaning that the text > is formatted for a line length of 78 for historical reasons). > > I prepared this change with the following GNU sed script. > > \# Handle simplest cases: ".BR foo (1)" and ".IR foo (1)". What I do to avoid git messing with these comments is to write a leading space. For git, only '#' in column 1 are special. Since most compilers and interpreters allow a space before a commented line, a leading space is fine. I've edited the commit message to have spaces, so that it's directly pastable into a MR.sed script. Oh, and I included "$ cat MR.sed;" in the commit message; I couldn't not do it. :) > s/^.[BI]R \(\\%\)*\([.@_[:alnum:]\\-]\+\) (\([1-9a-z]\+\))$/.MR \2 \3/ > \# Handle case: trailing punctuation, as in ".IR foo (1),". > s/^.[BI]R \(\\%\)*\([.@_[:alnum:]\\-]\+\) (\([1-9a-z]\+\))\([^[:space:]]\+\)$/.MR \2 \3 \4/ > \# Handle case: leading punctuation, as in ".RI ( foo (1)". > s/^.R[BI] \(\\%\)*\([^[:space:]]\+\) \([.@_[:alnum:]\\-]\+\) (\([1-9a-z]\+\))\([^[:space:]]\+\)$/\\%\2\\c\n.MR \3 \4 \5/ > \# Handle case: 3rd+ arguments or trailing comments. This case is rare > \# and will require manual fixup if there are 4+ arguments to MR. Use > \# groff -man -rCHECKSTYLE=1 to have them automatically reported. > s/^.[BI]R \(\\%\)*\([.@_[:alnum:]\\-]\+\) (\([1-8a-z]\+\))\( .*\)/.MR \2 \3\4/ > > Confirmed no errors arising in `MR` argument count as follows. > > $ groff --version | head -n 1 > GNU groff version 1.23.0 > $ groff -z -t -rCHECKSTYLE=1 -m andoc -T utf8 -P -cbou \ > $(grep -L '^\.so ' man*/* | sort) 2>&1 | grep MR | grep . \ > || echo "IT'S CLEAN" > IT'S CLEAN > > Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com> I've applied the patch (or rather, the script), but won't push it yet. If you send a run of commands that prove no differences before and after, I'll amend the commit message with it. Thank you! Cheers, Alex > --- > man1/getent.1 | 120 ++--- > man1/iconv.1 | 24 +- > man1/intro.1 | 54 +-- > man1/ldd.1 | 16 +- > man1/locale.1 | 16 +- > man1/localedef.1 | 15 +- > man1/memusage.1 | 58 +-- > man1/memusagestat.1 | 8 +- > man1/mtrace.1 | 10 +- > man1/pldd.1 | 12 +- > man1/sprof.1 | 6 +- > man1/time.1 | 32 +- > man2/_exit.2 | 44 +- > man2/_syscall.2 | 12 +- > man2/accept.2 | 46 +- > man2/access.2 | 42 +- > man2/acct.2 | 8 +- > man2/add_key.2 | 41 +- > man2/adjtimex.2 | 26 +- > man2/alarm.2 | 30 +- > man2/alloc_hugepages.2 | 4 +- > man2/arch_prctl.2 | 22 +- > man2/bdflush.2 | 6 +- > man2/bind.2 | 48 +- > man2/bpf.2 | 28 +- > man2/brk.2 | 14 +- > man2/cacheflush.2 | 2 +- > man2/capget.2 | 26 +- > man2/chdir.2 | 14 +- > man2/chmod.2 | 38 +- > man2/chown.2 | 30 +- > man2/chroot.2 | 26 +- > man2/clock_getres.2 | 58 +-- > man2/clock_nanosleep.2 | 42 +- > man2/clone.2 | 217 ++++----- > man2/close.2 | 42 +- > man2/close_range.2 | 16 +- > man2/connect.2 | 32 +- > man2/copy_file_range.2 | 10 +- > man2/create_module.2 | 8 +- > man2/delete_module.2 | 18 +- > man2/dup.2 | 28 +- > man2/epoll_create.2 | 14 +- > man2/epoll_ctl.2 | 46 +- > man2/epoll_wait.2 | 26 +- > man2/eventfd.2 | 108 ++--- > man2/execve.2 | 134 +++--- > man2/execveat.2 | 22 +- > man2/exit_group.2 | 6 +- > man2/fallocate.2 | 32 +- > man2/fanotify_init.2 | 42 +- > man2/fanotify_mark.2 | 44 +- > man2/fcntl.2 | 252 +++++----- > man2/flock.2 | 58 +-- > man2/fork.2 | 119 ++--- > man2/fsync.2 | 40 +- > man2/futex.2 | 34 +- > man2/futimesat.2 | 26 +- > man2/get_kernel_syms.2 | 12 +- > man2/get_mempolicy.2 | 32 +- > man2/get_robust_list.2 | 18 +- > man2/getcpu.2 | 16 +- > man2/getdents.2 | 16 +- > man2/getdomainname.2 | 14 +- > man2/getgid.2 | 10 +- > man2/getgroups.2 | 26 +- > man2/gethostname.2 | 16 +- > man2/getitimer.2 | 29 +- > man2/getpagesize.2 | 8 +- > man2/getpeername.2 | 26 +- > man2/getpid.2 | 46 +- > man2/getpriority.2 | 22 +- > man2/getrandom.2 | 20 +- > man2/getresuid.2 | 10 +- > man2/getrlimit.2 | 140 +++--- > man2/getrusage.2 | 18 +- > man2/getsid.2 | 10 +- > man2/getsockname.2 | 12 +- > man2/getsockopt.2 | 26 +- > man2/gettid.2 | 38 +- > man2/gettimeofday.2 | 38 +- > man2/getuid.2 | 10 +- > man2/getunwind.2 | 4 +- > man2/getxattr.2 | 30 +- > man2/init_module.2 | 16 +- > man2/inotify_add_watch.2 | 14 +- > man2/inotify_init.2 | 14 +- > man2/inotify_rm_watch.2 | 8 +- > man2/intro.2 | 54 +-- > man2/io_cancel.2 | 14 +- > man2/io_destroy.2 | 14 +- > man2/io_getevents.2 | 22 +- > man2/io_setup.2 | 16 +- > man2/io_submit.2 | 30 +- > man2/ioctl.2 | 34 +- > man2/ioctl_console.2 | 50 +- > man2/ioctl_fat.2 | 22 +- > man2/ioctl_ficlonerange.2 | 6 +- > man2/ioctl_fideduperange.2 | 6 +- > man2/ioctl_fslabel.2 | 6 +- > man2/ioctl_getfsmap.2 | 4 +- > man2/ioctl_iflags.2 | 42 +- > man2/ioctl_ns.2 | 28 +- > man2/ioctl_pipe.2 | 8 +- > man2/ioctl_tty.2 | 48 +- > man2/ioctl_userfaultfd.2 | 54 +-- > man2/ioperm.2 | 14 +- > man2/iopl.2 | 12 +- > man2/ioprio_set.2 | 23 +- > man2/ipc.2 | 34 +- > man2/kcmp.2 | 42 +- > man2/kexec_load.2 | 12 +- > man2/keyctl.2 | 244 +++++----- > man2/kill.2 | 28 +- > man2/landlock_add_rule.2 | 16 +- > man2/landlock_create_ruleset.2 | 16 +- > man2/landlock_restrict_self.2 | 18 +- > man2/link.2 | 38 +- > man2/listen.2 | 26 +- > man2/listxattr.2 | 32 +- > man2/llseek.2 | 14 +- > man2/lookup_dcookie.2 | 6 +- > man2/lseek.2 | 20 +- > man2/madvise.2 | 68 +-- > man2/mbind.2 | 42 +- > man2/membarrier.2 | 2 +- > man2/memfd_create.2 | 68 +-- > man2/memfd_secret.2 | 38 +- > man2/migrate_pages.2 | 30 +- > man2/mincore.2 | 16 +- > man2/mkdir.2 | 30 +- > man2/mknod.2 | 40 +- > man2/mlock.2 | 46 +- > man2/mmap.2 | 82 ++-- > man2/mmap2.2 | 20 +- > man2/modify_ldt.2 | 12 +- > man2/mount.2 | 74 +-- > man2/mount_setattr.2 | 76 +-- > man2/move_pages.2 | 28 +- > man2/mprotect.2 | 22 +- > man2/mq_getsetattr.2 | 10 +- > man2/mremap.2 | 38 +- > man2/msgctl.2 | 24 +- > man2/msgget.2 | 20 +- > man2/msgop.2 | 18 +- > man2/msync.2 | 8 +- > man2/nanosleep.2 | 36 +- > man2/nfsservctl.2 | 4 +- > man2/nice.2 | 28 +- > man2/open.2 | 320 ++++++------- > man2/open_by_handle_at.2 | 24 +- > man2/openat2.2 | 48 +- > man2/outb.2 | 8 +- > man2/pause.2 | 8 +- > man2/pciconfig_read.2 | 2 +- > man2/perf_event_open.2 | 100 ++-- > man2/perfmonctl.2 | 14 +- > man2/personality.2 | 20 +- > man2/pidfd_getfd.2 | 26 +- > man2/pidfd_open.2 | 60 +-- > man2/pidfd_send_signal.2 | 30 +- > man2/pipe.2 | 46 +- > man2/pivot_root.2 | 36 +- > man2/pkey_alloc.2 | 10 +- > man2/poll.2 | 42 +- > man2/posix_fadvise.2 | 26 +- > man2/prctl.2 | 259 ++++++----- > man2/pread.2 | 26 +- > man2/process_madvise.2 | 30 +- > man2/process_vm_readv.2 | 10 +- > man2/ptrace.2 | 277 +++++------ > man2/query_module.2 | 14 +- > man2/quotactl.2 | 14 +- > man2/read.2 | 40 +- > man2/readahead.2 | 12 +- > man2/readdir.2 | 10 +- > man2/readlink.2 | 28 +- > man2/readv.2 | 40 +- > man2/reboot.2 | 36 +- > man2/recv.2 | 80 ++-- > man2/recvmmsg.2 | 28 +- > man2/remap_file_pages.2 | 24 +- > man2/removexattr.2 | 26 +- > man2/rename.2 | 26 +- > man2/request_key.2 | 78 ++-- > man2/restart_syscall.2 | 20 +- > man2/rmdir.2 | 18 +- > man2/rt_sigqueueinfo.2 | 38 +- > man2/s390_guarded_storage.2 | 4 +- > man2/s390_pci_mmio_write.2 | 4 +- > man2/s390_runtime_instr.2 | 6 +- > man2/s390_sthyi.2 | 4 +- > man2/sched_get_priority_max.2 | 16 +- > man2/sched_rr_get_interval.2 | 8 +- > man2/sched_setaffinity.2 | 72 +-- > man2/sched_setattr.2 | 78 ++-- > man2/sched_setparam.2 | 34 +- > man2/sched_setscheduler.2 | 56 +-- > man2/sched_yield.2 | 2 +- > man2/seccomp.2 | 141 +++--- > man2/seccomp_unotify.2 | 178 +++---- > man2/select.2 | 66 +-- > man2/select_tut.2 | 84 ++-- > man2/semctl.2 | 32 +- > man2/semget.2 | 36 +- > man2/semop.2 | 34 +- > man2/send.2 | 78 ++-- > man2/sendfile.2 | 26 +- > man2/sendmmsg.2 | 18 +- > man2/set_mempolicy.2 | 30 +- > man2/set_thread_area.2 | 18 +- > man2/set_tid_address.2 | 12 +- > man2/seteuid.2 | 20 +- > man2/setfsgid.2 | 14 +- > man2/setfsuid.2 | 16 +- > man2/setgid.2 | 14 +- > man2/setns.2 | 38 +- > man2/setpgid.2 | 42 +- > man2/setresuid.2 | 22 +- > man2/setreuid.2 | 24 +- > man2/setsid.2 | 24 +- > man2/setuid.2 | 22 +- > man2/setxattr.2 | 28 +- > man2/sgetmask.2 | 10 +- > man2/shmctl.2 | 35 +- > man2/shmget.2 | 32 +- > man2/shmop.2 | 24 +- > man2/shutdown.2 | 8 +- > man2/sigaction.2 | 136 +++--- > man2/sigaltstack.2 | 32 +- > man2/signal.2 | 60 +-- > man2/signalfd.2 | 130 +++--- > man2/sigpending.2 | 24 +- > man2/sigprocmask.2 | 42 +- > man2/sigreturn.2 | 20 +- > man2/sigsuspend.2 | 30 +- > man2/sigwaitinfo.2 | 40 +- > man2/socket.2 | 120 ++--- > man2/socketcall.2 | 84 ++-- > man2/socketpair.2 | 16 +- > man2/splice.2 | 26 +- > man2/spu_create.2 | 28 +- > man2/spu_run.2 | 18 +- > man2/stat.2 | 38 +- > man2/statfs.2 | 36 +- > man2/statx.2 | 66 +-- > man2/stime.2 | 10 +- > man2/subpage_prot.2 | 6 +- > man2/swapon.2 | 14 +- > man2/symlink.2 | 32 +- > man2/sync.2 | 10 +- > man2/sync_file_range.2 | 10 +- > man2/syscall.2 | 54 +-- > man2/syscalls.2 | 128 ++--- > man2/sysctl.2 | 4 +- > man2/sysfs.2 | 6 +- > man2/sysinfo.2 | 2 +- > man2/syslog.2 | 10 +- > man2/tee.2 | 18 +- > man2/time.2 | 16 +- > man2/timer_create.2 | 64 +-- > man2/timer_delete.2 | 12 +- > man2/timer_getoverrun.2 | 26 +- > man2/timer_settime.2 | 20 +- > man2/timerfd_create.2 | 113 ++--- > man2/times.2 | 22 +- > man2/tkill.2 | 16 +- > man2/truncate.2 | 24 +- > man2/umask.2 | 47 +- > man2/umount.2 | 14 +- > man2/uname.2 | 12 +- > man2/unimplemented.2 | 26 +- > man2/unlink.2 | 44 +- > man2/unshare.2 | 77 +-- > man2/uselib.2 | 26 +- > man2/userfaultfd.2 | 106 ++--- > man2/ustat.2 | 6 +- > man2/utime.2 | 20 +- > man2/utimensat.2 | 46 +- > man2/vfork.2 | 88 ++-- > man2/vhangup.2 | 6 +- > man2/vmsplice.2 | 18 +- > man2/wait.2 | 80 ++-- > man2/wait4.2 | 28 +- > man2/write.2 | 56 +-- > man2type/open_how.2type | 4 +- > man3/CPU_SET.3 | 14 +- > man3/INFINITY.3 | 4 +- > man3/MAX.3 | 8 +- > man3/MB_CUR_MAX.3 | 12 +- > man3/MB_LEN_MAX.3 | 2 +- > man3/_Generic.3 | 2 +- > man3/__ppc_get_timebase.3 | 4 +- > man3/__ppc_set_ppr_med.3 | 4 +- > man3/__ppc_yield.3 | 4 +- > man3/__setfpucw.3 | 24 +- > man3/a64l.3 | 10 +- > man3/abort.3 | 24 +- > man3/abs.3 | 14 +- > man3/acos.3 | 20 +- > man3/acosh.3 | 18 +- > man3/addseverity.3 | 8 +- > man3/adjtime.3 | 14 +- > man3/aio_cancel.3 | 36 +- > man3/aio_error.3 | 32 +- > man3/aio_fsync.3 | 28 +- > man3/aio_init.3 | 2 +- > man3/aio_read.3 | 34 +- > man3/aio_return.3 | 32 +- > man3/aio_suspend.3 | 36 +- > man3/aio_write.3 | 32 +- > man3/alloca.3 | 24 +- > man3/arc4random.3 | 14 +- > man3/argz_add.3 | 8 +- > man3/asin.3 | 20 +- > man3/asinh.3 | 16 +- > man3/asprintf.3 | 16 +- > man3/assert.3 | 10 +- > man3/assert_perror.3 | 12 +- > man3/atan.3 | 20 +- > man3/atan2.3 | 18 +- > man3/atanh.3 | 18 +- > man3/atexit.3 | 36 +- > man3/atof.3 | 14 +- > man3/atoi.3 | 12 +- > man3/backtrace.3 | 24 +- > man3/basename.3 | 8 +- > man3/bcmp.3 | 4 +- > man3/bcopy.3 | 22 +- > man3/bindresvport.3 | 12 +- > man3/bsd_signal.3 | 28 +- > man3/bsearch.3 | 12 +- > man3/bstring.3 | 24 +- > man3/bswap.3 | 4 +- > man3/btowc.3 | 12 +- > man3/btree.3 | 18 +- > man3/byteorder.3 | 10 +- > man3/bzero.3 | 8 +- > man3/cabs.3 | 10 +- > man3/cacos.3 | 8 +- > man3/cacosh.3 | 12 +- > man3/canonicalize_file_name.3 | 10 +- > man3/carg.3 | 6 +- > man3/casin.3 | 8 +- > man3/casinh.3 | 12 +- > man3/catan.3 | 10 +- > man3/catanh.3 | 12 +- > man3/catgets.3 | 8 +- > man3/catopen.3 | 12 +- > man3/cbrt.3 | 8 +- > man3/ccos.3 | 12 +- > man3/ccosh.3 | 10 +- > man3/ceil.3 | 16 +- > man3/cexp.3 | 12 +- > man3/cexp2.3 | 8 +- > man3/cfree.3 | 22 +- > man3/cimag.3 | 8 +- > man3/circleq.3 | 4 +- > man3/clearenv.3 | 30 +- > man3/clock.3 | 16 +- > man3/clock_getcpuclockid.3 | 16 +- > man3/clog.3 | 14 +- > man3/clog10.3 | 12 +- > man3/clog2.3 | 10 +- > man3/closedir.3 | 16 +- > man3/cmsg.3 | 18 +- > man3/confstr.3 | 18 +- > man3/conj.3 | 8 +- > man3/copysign.3 | 6 +- > man3/cos.3 | 22 +- > man3/cosh.3 | 18 +- > man3/cpow.3 | 8 +- > man3/cproj.3 | 6 +- > man3/creal.3 | 8 +- > man3/crypt.3 | 24 +- > man3/csin.3 | 12 +- > man3/csinh.3 | 12 +- > man3/csqrt.3 | 8 +- > man3/ctan.3 | 12 +- > man3/ctanh.3 | 12 +- > man3/ctermid.3 | 6 +- > man3/ctime.3 | 40 +- > man3/daemon.3 | 26 +- > man3/dbopen.3 | 46 +- > man3/des_crypt.3 | 10 +- > man3/difftime.3 | 14 +- > man3/dirfd.3 | 28 +- > man3/div.3 | 8 +- > man3/dl_iterate_phdr.3 | 16 +- > man3/dladdr.3 | 16 +- > man3/dlerror.3 | 12 +- > man3/dlinfo.3 | 22 +- > man3/dlopen.3 | 50 +- > man3/dlsym.3 | 28 +- > man3/drand48.3 | 8 +- > man3/drand48_r.3 | 12 +- > man3/duplocale.3 | 28 +- > man3/dysize.3 | 6 +- > man3/ecvt.3 | 18 +- > man3/ecvt_r.3 | 24 +- > man3/encrypt.3 | 10 +- > man3/end.3 | 14 +- > man3/endian.3 | 10 +- > man3/envz_add.3 | 6 +- > man3/erf.3 | 12 +- > man3/erfc.3 | 12 +- > man3/err.3 | 16 +- > man3/errno.3 | 30 +- > man3/error.3 | 20 +- > man3/ether_aton.3 | 4 +- > man3/euidaccess.3 | 32 +- > man3/exec.3 | 32 +- > man3/exit.3 | 56 +-- > man3/exp.3 | 18 +- > man3/exp10.3 | 18 +- > man3/exp2.3 | 20 +- > man3/expm1.3 | 12 +- > man3/fabs.3 | 16 +- > man3/fclose.3 | 26 +- > man3/fcloseall.3 | 14 +- > man3/fdim.3 | 8 +- > man3/fenv.3 | 4 +- > man3/ferror.3 | 22 +- > man3/fexecve.3 | 20 +- > man3/fflush.3 | 28 +- > man3/ffs.3 | 6 +- > man3/fgetc.3 | 38 +- > man3/fgetgrent.3 | 24 +- > man3/fgetpwent.3 | 26 +- > man3/fgetwc.3 | 16 +- > man3/fgetws.3 | 12 +- > man3/fileno.3 | 18 +- > man3/finite.3 | 8 +- > man3/flockfile.3 | 18 +- > man3/floor.3 | 16 +- > man3/fma.3 | 12 +- > man3/fmax.3 | 8 +- > man3/fmemopen.3 | 32 +- > man3/fmin.3 | 8 +- > man3/fmod.3 | 8 +- > man3/fmtmsg.3 | 8 +- > man3/fnmatch.3 | 14 +- > man3/fopen.3 | 49 +- > man3/fopencookie.3 | 20 +- > man3/fpathconf.3 | 16 +- > man3/fpclassify.3 | 12 +- > man3/fpurge.3 | 14 +- > man3/fputwc.3 | 14 +- > man3/fputws.3 | 12 +- > man3/fread.3 | 18 +- > man3/frexp.3 | 8 +- > man3/fseek.3 | 20 +- > man3/fseeko.3 | 14 +- > man3/ftime.3 | 14 +- > man3/ftok.3 | 22 +- > man3/fts.3 | 36 +- > man3/ftw.3 | 28 +- > man3/futimes.3 | 18 +- > man3/fwide.3 | 10 +- > man3/gamma.3 | 26 +- > man3/gcvt.3 | 16 +- > man3/get_nprocs.3 | 6 +- > man3/get_phys_pages.3 | 6 +- > man3/getaddrinfo.3 | 50 +- > man3/getaddrinfo_a.3 | 36 +- > man3/getauxval.3 | 22 +- > man3/getcontext.3 | 48 +- > man3/getcwd.3 | 34 +- > man3/getdate.3 | 26 +- > man3/getdirentries.3 | 12 +- > man3/getdtablesize.3 | 16 +- > man3/getentropy.3 | 14 +- > man3/getenv.3 | 24 +- > man3/getfsent.3 | 8 +- > man3/getgrent.3 | 28 +- > man3/getgrent_r.3 | 32 +- > man3/getgrnam.3 | 24 +- > man3/getgrouplist.3 | 18 +- > man3/gethostbyname.3 | 59 +-- > man3/gethostid.3 | 14 +- > man3/getifaddrs.3 | 32 +- > man3/getipnodebyname.3 | 16 +- > man3/getline.3 | 18 +- > man3/getloadavg.3 | 8 +- > man3/getlogin.3 | 18 +- > man3/getmntent.3 | 16 +- > man3/getnameinfo.3 | 42 +- > man3/getnetent.3 | 8 +- > man3/getnetent_r.3 | 14 +- > man3/getopt.3 | 16 +- > man3/getpass.3 | 10 +- > man3/getprotoent.3 | 12 +- > man3/getprotoent_r.3 | 14 +- > man3/getpt.3 | 18 +- > man3/getpw.3 | 22 +- > man3/getpwent.3 | 28 +- > man3/getpwent_r.3 | 28 +- > man3/getpwnam.3 | 30 +- > man3/getrpcent.3 | 10 +- > man3/getrpcent_r.3 | 14 +- > man3/getrpcport.3 | 2 +- > man3/gets.3 | 36 +- > man3/getservent.3 | 12 +- > man3/getservent_r.3 | 14 +- > man3/getspnam.3 | 16 +- > man3/getsubopt.3 | 10 +- > man3/getttyent.3 | 6 +- > man3/getusershell.3 | 6 +- > man3/getutent.3 | 16 +- > man3/getutmp.3 | 8 +- > man3/getw.3 | 20 +- > man3/getwchar.3 | 10 +- > man3/glob.3 | 44 +- > man3/gnu_get_libc_version.3 | 4 +- > man3/grantpt.3 | 20 +- > man3/group_member.3 | 12 +- > man3/gsignal.3 | 18 +- > man3/hash.3 | 20 +- > man3/hsearch.3 | 12 +- > man3/hypot.3 | 10 +- > man3/iconv.3 | 10 +- > man3/iconv_close.3 | 8 +- > man3/iconv_open.3 | 16 +- > man3/if_nameindex.3 | 28 +- > man3/if_nametoindex.3 | 12 +- > man3/ilogb.3 | 14 +- > man3/index.3 | 16 +- > man3/inet.3 | 28 +- > man3/inet_net_pton.3 | 6 +- > man3/inet_ntop.3 | 14 +- > man3/inet_pton.3 | 20 +- > man3/initgroups.3 | 12 +- > man3/insque.3 | 6 +- > man3/intro.3 | 30 +- > man3/isalpha.3 | 46 +- > man3/isatty.3 | 6 +- > man3/isfdtype.3 | 10 +- > man3/isgreater.3 | 8 +- > man3/iswalnum.3 | 8 +- > man3/iswalpha.3 | 8 +- > man3/iswblank.3 | 10 +- > man3/iswcntrl.3 | 8 +- > man3/iswctype.3 | 30 +- > man3/iswdigit.3 | 8 +- > man3/iswgraph.3 | 8 +- > man3/iswlower.3 | 10 +- > man3/iswprint.3 | 8 +- > man3/iswpunct.3 | 8 +- > man3/iswspace.3 | 8 +- > man3/iswupper.3 | 10 +- > man3/iswxdigit.3 | 8 +- > man3/j0.3 | 10 +- > man3/key_setsecret.3 | 4 +- > man3/killpg.3 | 20 +- > man3/ldexp.3 | 12 +- > man3/lgamma.3 | 8 +- > man3/lio_listio.3 | 40 +- > man3/list.3 | 4 +- > man3/localeconv.3 | 26 +- > man3/lockf.3 | 14 +- > man3/log.3 | 18 +- > man3/log10.3 | 22 +- > man3/log1p.3 | 12 +- > man3/log2.3 | 20 +- > man3/logb.3 | 10 +- > man3/login.3 | 14 +- > man3/lrint.3 | 22 +- > man3/lround.3 | 24 +- > man3/lsearch.3 | 8 +- > man3/lseek64.3 | 14 +- > man3/makecontext.3 | 26 +- > man3/makedev.3 | 10 +- > man3/mallinfo.3 | 38 +- > man3/malloc.3 | 50 +- > man3/malloc_get_state.3 | 20 +- > man3/malloc_hook.3 | 26 +- > man3/malloc_info.3 | 20 +- > man3/malloc_stats.3 | 20 +- > man3/malloc_trim.3 | 16 +- > man3/malloc_usable_size.3 | 8 +- > man3/mallopt.3 | 68 +-- > man3/matherr.3 | 18 +- > man3/mblen.3 | 6 +- > man3/mbrlen.3 | 4 +- > man3/mbrtowc.3 | 6 +- > man3/mbsinit.3 | 18 +- > man3/mbsnrtowcs.3 | 14 +- > man3/mbsrtowcs.3 | 12 +- > man3/mbstowcs.3 | 14 +- > man3/mbtowc.3 | 16 +- > man3/mcheck.3 | 16 +- > man3/memccpy.3 | 14 +- > man3/memchr.3 | 28 +- > man3/memcmp.3 | 16 +- > man3/memcpy.3 | 22 +- > man3/memfrob.3 | 6 +- > man3/memmem.3 | 6 +- > man3/memmove.3 | 16 +- > man3/mempcpy.3 | 12 +- > man3/memset.3 | 10 +- > man3/mkdtemp.3 | 20 +- > man3/mkfifo.3 | 26 +- > man3/mkstemp.3 | 24 +- > man3/mktemp.3 | 20 +- > man3/modf.3 | 8 +- > man3/mpool.3 | 20 +- > man3/mq_close.3 | 20 +- > man3/mq_getattr.3 | 30 +- > man3/mq_notify.3 | 30 +- > man3/mq_open.3 | 36 +- > man3/mq_receive.3 | 28 +- > man3/mq_send.3 | 28 +- > man3/mq_unlink.3 | 16 +- > man3/mtrace.3 | 31 +- > man3/nan.3 | 14 +- > man3/netlink.3 | 6 +- > man3/newlocale.3 | 26 +- > man3/nextafter.3 | 8 +- > man3/nextup.3 | 6 +- > man3/nl_langinfo.3 | 62 +-- > man3/ntp_gettime.3 | 14 +- > man3/offsetof.3 | 2 +- > man3/on_exit.3 | 20 +- > man3/open_memstream.3 | 28 +- > man3/opendir.3 | 24 +- > man3/openpty.3 | 14 +- > man3/perror.3 | 14 +- > man3/popen.3 | 42 +- > man3/posix_fallocate.3 | 18 +- > man3/posix_madvise.3 | 10 +- > man3/posix_memalign.3 | 26 +- > man3/posix_openpt.3 | 24 +- > man3/posix_spawn.3 | 170 +++---- > man3/pow.3 | 12 +- > man3/pow10.3 | 8 +- > man3/powerof2.3 | 4 +- > man3/printf.3 | 46 +- > man3/profil.3 | 16 +- > man3/program_invocation_name.3 | 2 +- > man3/psignal.3 | 16 +- > man3/pthread_atfork.3 | 28 +- > man3/pthread_attr_init.3 | 40 +- > man3/pthread_attr_setaffinity_np.3 | 16 +- > man3/pthread_attr_setdetachstate.3 | 26 +- > man3/pthread_attr_setguardsize.3 | 26 +- > man3/pthread_attr_setinheritsched.3 | 35 +- > man3/pthread_attr_setschedparam.3 | 30 +- > man3/pthread_attr_setschedpolicy.3 | 26 +- > man3/pthread_attr_setscope.3 | 20 +- > man3/pthread_attr_setsigmask_np.3 | 20 +- > man3/pthread_attr_setstack.3 | 32 +- > man3/pthread_attr_setstackaddr.3 | 20 +- > man3/pthread_attr_setstacksize.3 | 20 +- > man3/pthread_cancel.3 | 34 +- > man3/pthread_cleanup_push.3 | 34 +- > man3/pthread_cleanup_push_defer_np.3 | 24 +- > man3/pthread_create.3 | 72 +-- > man3/pthread_detach.3 | 24 +- > man3/pthread_equal.3 | 8 +- > man3/pthread_exit.3 | 22 +- > man3/pthread_getattr_default_np.3 | 30 +- > man3/pthread_getattr_np.3 | 36 +- > man3/pthread_getcpuclockid.3 | 22 +- > man3/pthread_join.3 | 18 +- > man3/pthread_kill.3 | 22 +- > man3/pthread_kill_other_threads_np.3 | 18 +- > man3/pthread_mutex_consistent.3 | 14 +- > man3/pthread_mutexattr_getpshared.3 | 4 +- > man3/pthread_mutexattr_init.3 | 8 +- > man3/pthread_mutexattr_setrobust.3 | 34 +- > man3/pthread_rwlockattr_setkind_np.3 | 4 +- > man3/pthread_self.3 | 14 +- > man3/pthread_setaffinity_np.3 | 34 +- > man3/pthread_setcancelstate.3 | 22 +- > man3/pthread_setconcurrency.3 | 6 +- > man3/pthread_setname_np.3 | 10 +- > man3/pthread_setschedparam.3 | 40 +- > man3/pthread_setschedprio.3 | 30 +- > man3/pthread_sigmask.3 | 32 +- > man3/pthread_sigqueue.3 | 26 +- > man3/pthread_spin_init.3 | 16 +- > man3/pthread_spin_lock.3 | 12 +- > man3/pthread_testcancel.3 | 14 +- > man3/pthread_tryjoin_np.3 | 22 +- > man3/pthread_yield.3 | 14 +- > man3/ptsname.3 | 18 +- > man3/putenv.3 | 14 +- > man3/putgrent.3 | 10 +- > man3/putpwent.3 | 18 +- > man3/puts.3 | 28 +- > man3/putwchar.3 | 10 +- > man3/qecvt.3 | 24 +- > man3/qsort.3 | 16 +- > man3/raise.3 | 18 +- > man3/rand.3 | 16 +- > man3/random.3 | 16 +- > man3/random_r.3 | 22 +- > man3/rcmd.3 | 24 +- > man3/re_comp.3 | 8 +- > man3/readdir.3 | 38 +- > man3/readdir_r.3 | 22 +- > man3/realpath.3 | 30 +- > man3/recno.3 | 26 +- > man3/regex.3 | 8 +- > man3/remainder.3 | 14 +- > man3/remove.3 | 30 +- > man3/remquo.3 | 16 +- > man3/resolver.3 | 24 +- > man3/rewinddir.3 | 14 +- > man3/rexec.3 | 16 +- > man3/rint.3 | 20 +- > man3/round.3 | 22 +- > man3/roundup.3 | 12 +- > man3/rpc.3 | 14 +- > man3/rpmatch.3 | 24 +- > man3/rtime.3 | 17 +- > man3/rtnetlink.3 | 10 +- > man3/scalb.3 | 16 +- > man3/scalbln.3 | 16 +- > man3/scandir.3 | 40 +- > man3/scanf.3 | 30 +- > man3/sched_getcpu.3 | 12 +- > man3/seekdir.3 | 24 +- > man3/sem_close.3 | 16 +- > man3/sem_destroy.3 | 16 +- > man3/sem_getvalue.3 | 12 +- > man3/sem_init.3 | 28 +- > man3/sem_open.3 | 18 +- > man3/sem_post.3 | 16 +- > man3/sem_unlink.3 | 12 +- > man3/sem_wait.3 | 22 +- > man3/setaliasent.3 | 10 +- > man3/setbuf.3 | 24 +- > man3/setenv.3 | 14 +- > man3/setjmp.3 | 10 +- > man3/setlocale.3 | 36 +- > man3/setlogmask.3 | 10 +- > man3/setnetgrent.3 | 10 +- > man3/shm_open.3 | 48 +- > man3/siginterrupt.3 | 8 +- > man3/signbit.3 | 6 +- > man3/significand.3 | 8 +- > man3/sigpause.3 | 22 +- > man3/sigqueue.3 | 34 +- > man3/sigset.3 | 53 +-- > man3/sigsetops.3 | 14 +- > man3/sigvec.3 | 43 +- > man3/sigwait.3 | 26 +- > man3/sin.3 | 22 +- > man3/sincos.3 | 16 +- > man3/sinh.3 | 18 +- > man3/sleep.3 | 22 +- > man3/slist.3 | 4 +- > man3/sockatmark.3 | 16 +- > man3/sqrt.3 | 12 +- > man3/sscanf.3 | 32 +- > man3/stailq.3 | 4 +- > man3/static_assert.3 | 4 +- > man3/statvfs.3 | 26 +- > man3/stdarg.3 | 10 +- > man3/stdin.3 | 46 +- > man3/stdio.3 | 24 +- > man3/stdio_ext.3 | 8 +- > man3/stpncpy.3 | 10 +- > man3/strcasecmp.3 | 16 +- > man3/strchr.3 | 22 +- > man3/strcmp.3 | 24 +- > man3/strcoll.3 | 18 +- > man3/strcpy.3 | 14 +- > man3/strdup.3 | 24 +- > man3/strerror.3 | 18 +- > man3/strfmon.3 | 12 +- > man3/strfromd.3 | 12 +- > man3/strfry.3 | 6 +- > man3/strftime.3 | 48 +- > man3/string.3 | 52 +-- > man3/strlen.3 | 12 +- > man3/strncat.3 | 10 +- > man3/strnlen.3 | 6 +- > man3/strpbrk.3 | 18 +- > man3/strptime.3 | 24 +- > man3/strsep.3 | 24 +- > man3/strsignal.3 | 8 +- > man3/strspn.3 | 20 +- > man3/strstr.3 | 22 +- > man3/strtod.3 | 26 +- > man3/strtoimax.3 | 16 +- > man3/strtok.3 | 22 +- > man3/strtol.3 | 20 +- > man3/strtoul.3 | 22 +- > man3/strverscmp.3 | 20 +- > man3/strxfrm.3 | 20 +- > man3/swab.3 | 4 +- > man3/sysconf.3 | 52 +-- > man3/syslog.3 | 26 +- > man3/system.3 | 52 +-- > man3/sysv_signal.3 | 22 +- > man3/tailq.3 | 4 +- > man3/tan.3 | 20 +- > man3/tanh.3 | 16 +- > man3/tcgetpgrp.3 | 8 +- > man3/tcgetsid.3 | 6 +- > man3/telldir.3 | 18 +- > man3/tempnam.3 | 30 +- > man3/termios.3 | 74 +-- > man3/tgamma.3 | 14 +- > man3/timegm.3 | 18 +- > man3/timeradd.3 | 6 +- > man3/tmpfile.3 | 14 +- > man3/tmpnam.3 | 28 +- > man3/toascii.3 | 10 +- > man3/toupper.3 | 20 +- > man3/towctrans.3 | 10 +- > man3/towlower.3 | 16 +- > man3/towupper.3 | 16 +- > man3/trunc.3 | 16 +- > man3/tsearch.3 | 10 +- > man3/ttyname.3 | 14 +- > man3/ttyslot.3 | 20 +- > man3/tzset.3 | 22 +- > man3/ualarm.3 | 45 +- > man3/ulimit.3 | 18 +- > man3/undocumented.3 | 264 +++++------ > man3/ungetwc.3 | 6 +- > man3/unlocked_stdio.3 | 10 +- > man3/unlockpt.3 | 14 +- > man3/updwtmp.3 | 8 +- > man3/uselocale.3 | 28 +- > man3/usleep.3 | 46 +- > man3/wcpcpy.3 | 10 +- > man3/wcpncpy.3 | 10 +- > man3/wcrtomb.3 | 6 +- > man3/wcscasecmp.3 | 15 +- > man3/wcscat.3 | 12 +- > man3/wcschr.3 | 14 +- > man3/wcscmp.3 | 10 +- > man3/wcscpy.3 | 14 +- > man3/wcscspn.3 | 10 +- > man3/wcsdup.3 | 14 +- > man3/wcslen.3 | 8 +- > man3/wcsncasecmp.3 | 15 +- > man3/wcsncat.3 | 8 +- > man3/wcsncmp.3 | 8 +- > man3/wcsncpy.3 | 6 +- > man3/wcsnlen.3 | 10 +- > man3/wcsnrtombs.3 | 12 +- > man3/wcspbrk.3 | 10 +- > man3/wcsrchr.3 | 8 +- > man3/wcsrtombs.3 | 12 +- > man3/wcsspn.3 | 8 +- > man3/wcsstr.3 | 8 +- > man3/wcstoimax.3 | 18 +- > man3/wcstok.3 | 8 +- > man3/wcstombs.3 | 14 +- > man3/wcswidth.3 | 6 +- > man3/wctob.3 | 12 +- > man3/wctomb.3 | 16 +- > man3/wctrans.3 | 6 +- > man3/wctype.3 | 6 +- > man3/wcwidth.3 | 6 +- > man3/wmemchr.3 | 8 +- > man3/wmemcmp.3 | 8 +- > man3/wmemcpy.3 | 14 +- > man3/wmemmove.3 | 8 +- > man3/wmemset.3 | 6 +- > man3/wordexp.3 | 16 +- > man3/wprintf.3 | 48 +- > man3/xcrypt.3 | 4 +- > man3/xdr.3 | 12 +- > man3/y0.3 | 10 +- > man3const/EOF.3const | 4 +- > man3const/EXIT_SUCCESS.3const | 6 +- > man3const/NULL.3const | 8 +- > man3head/printf.h.3head | 22 +- > man3head/sysexits.h.3head | 12 +- > man3type/FILE.3type | 16 +- > man3type/aiocb.3type | 18 +- > man3type/blkcnt_t.3type | 2 +- > man3type/blksize_t.3type | 2 +- > man3type/cc_t.3type | 2 +- > man3type/clock_t.3type | 4 +- > man3type/clockid_t.3type | 10 +- > man3type/dev_t.3type | 6 +- > man3type/div_t.3type | 10 +- > man3type/epoll_event.3type | 4 +- > man3type/fenv_t.3type | 4 +- > man3type/id_t.3type | 46 +- > man3type/intN_t.3type | 10 +- > man3type/intmax_t.3type | 12 +- > man3type/intptr_t.3type | 8 +- > man3type/iovec.3type | 4 +- > man3type/itimerspec.3type | 6 +- > man3type/lconv.3type | 8 +- > man3type/mode_t.3type | 10 +- > man3type/off_t.3type | 28 +- > man3type/ptrdiff_t.3type | 6 +- > man3type/size_t.3type | 34 +- > man3type/sockaddr.3type | 34 +- > man3type/stat.3type | 14 +- > man3type/time_t.3type | 12 +- > man3type/timer_t.3type | 10 +- > man3type/timespec.3type | 14 +- > man3type/timeval.3type | 18 +- > man3type/tm.3type | 20 +- > man3type/va_list.3type | 16 +- > man3type/void.3type | 14 +- > man4/cciss.4 | 18 +- > man4/console_codes.4 | 30 +- > man4/cpuid.4 | 6 +- > man4/dsp56k.4 | 10 +- > man4/fd.4 | 18 +- > man4/full.4 | 6 +- > man4/fuse.4 | 28 +- > man4/hd.4 | 8 +- > man4/hpsa.4 | 33 +- > man4/initrd.4 | 16 +- > man4/intro.4 | 6 +- > man4/lirc.4 | 16 +- > man4/loop.4 | 32 +- > man4/lp.4 | 16 +- > man4/mem.4 | 6 +- > man4/mouse.4 | 6 +- > man4/null.4 | 8 +- > man4/pts.4 | 24 +- > man4/ram.4 | 6 +- > man4/random.4 | 34 +- > man4/rtc.4 | 56 +-- > man4/sd.4 | 16 +- > man4/sk98lin.4 | 12 +- > man4/smartpqi.4 | 14 +- > man4/st.4 | 28 +- > man4/tty.4 | 28 +- > man4/ttyS.4 | 12 +- > man4/vcs.4 | 18 +- > man4/veth.4 | 12 +- > man4/wavelan.4 | 22 +- > man5/acct.5 | 12 +- > man5/charmap.5 | 12 +- > man5/core.5 | 97 ++-- > man5/dir_colors.5 | 18 +- > man5/elf.5 | 38 +- > man5/erofs.5 | 12 +- > man5/filesystems.5 | 46 +- > man5/ftpusers.5 | 6 +- > man5/gai.conf.5 | 4 +- > man5/group.5 | 24 +- > man5/host.conf.5 | 18 +- > man5/hosts.5 | 14 +- > man5/hosts.equiv.5 | 6 +- > man5/intro.5 | 2 +- > man5/issue.5 | 6 +- > man5/locale.5 | 58 +-- > man5/motd.5 | 6 +- > man5/networks.5 | 16 +- > man5/nologin.5 | 6 +- > man5/nscd.conf.5 | 10 +- > man5/nss.5 | 18 +- > man5/nsswitch.conf.5 | 32 +- > man5/passwd.5 | 48 +- > man5/proc.5 | 668 ++++++++++++++------------- > man5/protocols.5 | 2 +- > man5/repertoiremap.5 | 10 +- > man5/resolv.conf.5 | 36 +- > man5/rpc.5 | 2 +- > man5/securetty.5 | 12 +- > man5/services.5 | 48 +- > man5/shells.5 | 8 +- > man5/slabinfo.5 | 2 +- > man5/sysfs.5 | 12 +- > man5/termcap.5 | 10 +- > man5/tmpfs.5 | 37 +- > man5/ttytype.5 | 14 +- > man5/tzfile.5 | 24 +- > man5/utmp.5 | 78 ++-- > man7/address_families.7 | 38 +- > man7/aio.7 | 76 +-- > man7/armscii-8.7 | 8 +- > man7/arp.7 | 16 +- > man7/ascii.7 | 34 +- > man7/attributes.7 | 20 +- > man7/boot.7 | 34 +- > man7/bootparam.7 | 22 +- > man7/capabilities.7 | 413 +++++++++-------- > man7/cgroup_namespaces.7 | 34 +- > man7/cgroups.7 | 74 +-- > man7/charsets.7 | 14 +- > man7/complex.7 | 52 +-- > man7/cp1251.7 | 16 +- > man7/cp1252.7 | 14 +- > man7/cpuset.7 | 158 +++---- > man7/credentials.7 | 259 ++++++----- > man7/ddp.7 | 20 +- > man7/environ.7 | 110 ++--- > man7/epoll.7 | 117 ++--- > man7/fanotify.7 | 116 ++--- > man7/feature_test_macros.7 | 58 +-- > man7/fifo.7 | 20 +- > man7/futex.7 | 24 +- > man7/glob.7 | 12 +- > man7/hier.7 | 28 +- > man7/hostname.7 | 20 +- > man7/icmp.7 | 8 +- > man7/inode.7 | 72 +-- > man7/inotify.7 | 142 +++--- > man7/intro.7 | 2 +- > man7/ip.7 | 171 +++---- > man7/ipc_namespaces.7 | 20 +- > man7/ipv6.7 | 28 +- > man7/iso_8859-1.7 | 12 +- > man7/iso_8859-10.7 | 8 +- > man7/iso_8859-11.7 | 8 +- > man7/iso_8859-13.7 | 8 +- > man7/iso_8859-14.7 | 8 +- > man7/iso_8859-15.7 | 12 +- > man7/iso_8859-16.7 | 10 +- > man7/iso_8859-2.7 | 12 +- > man7/iso_8859-3.7 | 8 +- > man7/iso_8859-4.7 | 8 +- > man7/iso_8859-5.7 | 14 +- > man7/iso_8859-6.7 | 8 +- > man7/iso_8859-7.7 | 8 +- > man7/iso_8859-8.7 | 8 +- > man7/iso_8859-9.7 | 8 +- > man7/keyrings.7 | 152 +++--- > man7/koi8-r.7 | 14 +- > man7/koi8-u.7 | 14 +- > man7/landlock.7 | 86 ++-- > man7/libc.7 | 14 +- > man7/locale.7 | 127 ++--- > man7/mailaddr.7 | 8 +- > man7/man-pages.7 | 50 +- > man7/man.7 | 42 +- > man7/math_error.7 | 38 +- > man7/mount_namespaces.7 | 155 ++++--- > man7/mq_overview.7 | 94 ++-- > man7/namespaces.7 | 99 ++-- > man7/netdevice.7 | 20 +- > man7/netlink.7 | 32 +- > man7/network_namespaces.7 | 37 +- > man7/nptl.7 | 50 +- > man7/numa.7 | 26 +- > man7/packet.7 | 54 +-- > man7/path_resolution.7 | 40 +- > man7/persistent-keyring.7 | 52 +-- > man7/pid_namespaces.7 | 108 ++--- > man7/pipe.7 | 94 ++-- > man7/pkeys.7 | 34 +- > man7/posixoptions.7 | 18 +- > man7/process-keyring.7 | 26 +- > man7/pthreads.7 | 175 +++---- > man7/pty.7 | 56 +-- > man7/queue.7 | 12 +- > man7/random.7 | 26 +- > man7/raw.7 | 41 +- > man7/regex.7 | 8 +- > man7/rtld-audit.7 | 18 +- > man7/rtnetlink.7 | 14 +- > man7/sched.7 | 190 ++++---- > man7/sem_overview.7 | 61 +-- > man7/session-keyring.7 | 54 +-- > man7/shm_overview.7 | 58 +-- > man7/sigevent.7 | 26 +- > man7/signal-safety.7 | 38 +- > man7/signal.7 | 372 +++++++-------- > man7/sock_diag.7 | 26 +- > man7/socket.7 | 264 +++++------ > man7/spufs.7 | 140 +++--- > man7/standards.7 | 18 +- > man7/string_copying.7 | 176 +++---- > man7/suffixes.7 | 6 +- > man7/symlink.7 | 174 +++---- > man7/system_data_types.7 | 56 +-- > man7/sysvipc.7 | 66 +-- > man7/tcp.7 | 136 +++--- > man7/termio.7 | 22 +- > man7/thread-keyring.7 | 26 +- > man7/time.7 | 124 ++--- > man7/time_namespaces.7 | 48 +- > man7/udp.7 | 68 +-- > man7/udplite.7 | 26 +- > man7/unicode.7 | 14 +- > man7/unix.7 | 166 +++---- > man7/uri.7 | 20 +- > man7/user-keyring.7 | 44 +- > man7/user-session-keyring.7 | 44 +- > man7/user_namespaces.7 | 226 ++++----- > man7/utf-8.7 | 14 +- > man7/uts_namespaces.7 | 32 +- > man7/vdso.7 | 22 +- > man7/vsock.7 | 40 +- > man7/x25.7 | 12 +- > man7/xattr.7 | 40 +- > man8/iconvconfig.8 | 8 +- > man8/intro.8 | 2 +- > man8/ld.so.8 | 53 +-- > man8/ldconfig.8 | 4 +- > man8/nscd.8 | 28 +- > man8/sln.8 | 8 +- > man8/zdump.8 | 12 +- > man8/zic.8 | 6 +- > 1100 files changed, 15657 insertions(+), 15493 deletions(-) > > diff --git a/man1/getent.1 b/man1/getent.1 > index e9c5efb8a..4c9b419da 100644 > --- a/man1/getent.1 > +++ b/man1/getent.1 > @@ -35,10 +35,10 @@ .SH DESCRIPTION > When no > .I key > is provided, use > -.BR sethostent (3), > -.BR gethostent (3), > +.MR sethostent 3 , > +.MR gethostent 3 , > and > -.BR endhostent (3) > +.MR endhostent 3 > to enumerate the hosts database. > This is identical to using > .BR hosts . > @@ -47,7 +47,7 @@ .SH DESCRIPTION > arguments are provided, pass each > .I key > in succession to > -.BR getaddrinfo (3) > +.MR getaddrinfo 3 > with the address family > .BR AF_UNSPEC , > enumerating each socket address structure returned. > @@ -64,7 +64,7 @@ .SH DESCRIPTION > but use the address family > .BR AF_INET6 . > The call to > -.BR getaddrinfo (3) > +.MR getaddrinfo 3 > in this case includes the > .B AI_V4MAPPED > flag. > @@ -73,17 +73,17 @@ .SH DESCRIPTION > When no > .I key > is provided, use > -.BR setaliasent (3), > -.BR getaliasent (3), > +.MR setaliasent 3 , > +.MR getaliasent 3 , > and > -.BR endaliasent (3) > +.MR endaliasent 3 > to enumerate the aliases database. > When one or more > .I key > arguments are provided, pass each > .I key > in succession to > -.BR getaliasbyname (3) > +.MR getaliasbyname 3 > and display the result. > .TP > .B ethers > @@ -92,9 +92,9 @@ .SH DESCRIPTION > arguments are provided, pass each > .I key > in succession to > -.BR ether_aton (3) > +.MR ether_aton 3 > and > -.BR ether_hostton (3) > +.MR ether_hostton 3 > until a result is obtained, and display the result. > Enumeration is not supported on > .BR ethers , > @@ -106,59 +106,59 @@ .SH DESCRIPTION > When no > .I key > is provided, use > -.BR setgrent (3), > -.BR getgrent (3), > +.MR setgrent 3 , > +.MR getgrent 3 , > and > -.BR endgrent (3) > +.MR endgrent 3 > to enumerate the group database. > When one or more > .I key > arguments are provided, pass each numeric > .I key > to > -.BR getgrgid (3) > +.MR getgrgid 3 > and each nonnumeric > .I key > to > -.BR getgrnam (3) > +.MR getgrnam 3 > and display the result. > .TP > .B gshadow > When no > .I key > is provided, use > -.BR setsgent (3), > -.BR getsgent (3), > +.MR setsgent 3 , > +.MR getsgent 3 , > and > -.BR endsgent (3) > +.MR endsgent 3 > to enumerate the gshadow database. > When one or more > .I key > arguments are provided, pass each > .I key > in succession to > -.BR getsgnam (3) > +.MR getsgnam 3 > and display the result. > .TP > .B hosts > When no > .I key > is provided, use > -.BR sethostent (3), > -.BR gethostent (3), > +.MR sethostent 3 , > +.MR gethostent 3 , > and > -.BR endhostent (3) > +.MR endhostent 3 > to enumerate the hosts database. > When one or more > .I key > arguments are provided, pass each > .I key > to > -.BR gethostbyaddr (3) > +.MR gethostbyaddr 3 > or > -.BR gethostbyname2 (3), > +.MR gethostbyname2 3 , > depending on whether a call to > -.BR inet_pton (3) > +.MR inet_pton 3 > indicates that the > .I key > is an IPv6 or IPv4 address or not, and display the result. > @@ -169,7 +169,7 @@ .SH DESCRIPTION > arguments are provided, pass each > .I key > in succession to > -.BR getgrouplist (3) > +.MR getgrouplist 3 > and display the result. > Enumeration is not supported on > .BR initgroups , > @@ -183,9 +183,9 @@ .SH DESCRIPTION > is provided, pass the > .I key > to > -.BR setnetgrent (3) > +.MR setnetgrent 3 > and, using > -.BR getnetgrent (3) > +.MR getnetgrent 3 > display the resulting string triple > .RI ( hostname ", " username ", " domainname ). > Alternatively, three > @@ -196,7 +196,7 @@ .SH DESCRIPTION > and > .I domainname > to match to a netgroup name via > -.BR innetgr (3). > +.MR innetgr 3 . > Enumeration is not supported on > .BR netgroup , > so either one or three > @@ -207,122 +207,122 @@ .SH DESCRIPTION > When no > .I key > is provided, use > -.BR setnetent (3), > -.BR getnetent (3), > +.MR setnetent 3 , > +.MR getnetent 3 , > and > -.BR endnetent (3) > +.MR endnetent 3 > to enumerate the networks database. > When one or more > .I key > arguments are provided, pass each numeric > .I key > to > -.BR getnetbyaddr (3) > +.MR getnetbyaddr 3 > and each nonnumeric > .I key > to > -.BR getnetbyname (3) > +.MR getnetbyname 3 > and display the result. > .TP > .B passwd > When no > .I key > is provided, use > -.BR setpwent (3), > -.BR getpwent (3), > +.MR setpwent 3 , > +.MR getpwent 3 , > and > -.BR endpwent (3) > +.MR endpwent 3 > to enumerate the passwd database. > When one or more > .I key > arguments are provided, pass each numeric > .I key > to > -.BR getpwuid (3) > +.MR getpwuid 3 > and each nonnumeric > .I key > to > -.BR getpwnam (3) > +.MR getpwnam 3 > and display the result. > .TP > .B protocols > When no > .I key > is provided, use > -.BR setprotoent (3), > -.BR getprotoent (3), > +.MR setprotoent 3 , > +.MR getprotoent 3 , > and > -.BR endprotoent (3) > +.MR endprotoent 3 > to enumerate the protocols database. > When one or more > .I key > arguments are provided, pass each numeric > .I key > to > -.BR getprotobynumber (3) > +.MR getprotobynumber 3 > and each nonnumeric > .I key > to > -.BR getprotobyname (3) > +.MR getprotobyname 3 > and display the result. > .TP > .B rpc > When no > .I key > is provided, use > -.BR setrpcent (3), > -.BR getrpcent (3), > +.MR setrpcent 3 , > +.MR getrpcent 3 , > and > -.BR endrpcent (3) > +.MR endrpcent 3 > to enumerate the rpc database. > When one or more > .I key > arguments are provided, pass each numeric > .I key > to > -.BR getrpcbynumber (3) > +.MR getrpcbynumber 3 > and each nonnumeric > .I key > to > -.BR getrpcbyname (3) > +.MR getrpcbyname 3 > and display the result. > .TP > .B services > When no > .I key > is provided, use > -.BR setservent (3), > -.BR getservent (3), > +.MR setservent 3 , > +.MR getservent 3 , > and > -.BR endservent (3) > +.MR endservent 3 > to enumerate the services database. > When one or more > .I key > arguments are provided, pass each numeric > .I key > to > -.BR getservbynumber (3) > +.MR getservbynumber 3 > and each nonnumeric > .I key > to > -.BR getservbyname (3) > +.MR getservbyname 3 > and display the result. > .TP > .B shadow > When no > .I key > is provided, use > -.BR setspent (3), > -.BR getspent (3), > +.MR setspent 3 , > +.MR getspent 3 , > and > -.BR endspent (3) > +.MR endspent 3 > to enumerate the shadow database. > When one or more > .I key > arguments are provided, pass each > .I key > in succession to > -.BR getspnam (3) > +.MR getspnam 3 > and display the result. > .RE > .SH OPTIONS > @@ -379,4 +379,4 @@ .SH EXIT STATUS > .IR database . > .RE > .SH SEE ALSO > -.BR nsswitch.conf (5) > +.MR nsswitch.conf 5 > [DIFF TRUNCATED DUE TO IMMENSE SIZE AND VGER RESTRICTIONS] -- <http://www.alejandro-colomar.es/> GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5 [-- Attachment #2: OpenPGP digital signature --] [-- Type: application/pgp-signature, Size: 833 bytes --] ^ permalink raw reply [flat|nested] 17+ messages in thread
* Re: [PATCH v2] man*/: ffix (migrate to `MR`) 2023-07-31 21:47 ` Alejandro Colomar @ 2023-07-31 22:50 ` G. Branden Robinson 2023-07-31 23:15 ` Alejandro Colomar 0 siblings, 1 reply; 17+ messages in thread From: G. Branden Robinson @ 2023-07-31 22:50 UTC (permalink / raw) To: Alejandro Colomar; +Cc: linux-man [-- Attachment #1.1: Type: text/plain, Size: 3963 bytes --] Hi Alex, At 2023-07-31T23:47:50+0200, Alejandro Colomar wrote: > > When the text of all Linux man-pages documents (excluding those > > containing only `so` requests) is dumped, with adjustment mode 'l' > > ("-dAD=l") and automatic hyphenation disabled ("-rHY=0") before and > > after this change, there is no change to rendered output. > > It would be interesting to see a script that corroborates the above > paragraph. It might help other projects that may want to migrate to > MR. Sure. I used a couple of scripts. $ cat ATTIC/dump-pages.sh #!/bin/sh pages=$(grep -L '^\.so ' man*/* | sort) groff -t "$@" -m andoc -T utf8 -P -cbou $pages $ cat ATTIC/dump-pages-left-adjustment-no-hyphenation.sh #!/bin/sh pages=$(grep -L '^\.so ' man*/* | sort) groff -t -dAD=l -rHY=0 -m andoc -T utf8 -P -cbou $pages And here's how I ran them. sh ATTIC/dump-pages.sh >| DUMP1 sed -i -f ./ATTIC/MR.sed $(grep -L '^\.so ' man*/*) sh ATTIC/dump-pages-left-adjustment-no-hyphenation.sh >| DUMP2 diff -U0 -b DUMP1 DUMP2 | less -R That confirmed that there were "no changes" (with the caveat noted above). sh ATTIC/dump-pages.sh >| DUMP2 diff -U0 -b DUMP1 DUMP2 | less -R diff -U0 -b DUMP1 DUMP2 | wc -l I used these to eyeball and measure whether there were any formatting changes even with default adjustment and hyphenation enabled. It showed me _tons_ of man page names no longer getting broken (and hyphenated) across lines, and nothing else that I noticed. With the previous empty diff in hand, I decided that I hadn't regressed the text of the pages. If there are further sanity checks we can apply, I'm open to suggestions. Since you had me looking at my shell history, I'll share that I did a "git co ." (co = alias for "checkout") 18 times in the course of developing MR.sed. Those drove most of my recent patch submissions immediately prior to this one. I could have done 18 more without fatiguing (albeit not necessrily without frustration with myself for not getting my sed right). But that's the beauty of sed, and Bash/readline's "reverse-search-history" and "operate-and-get-next" features. As it turned out, my sed was pretty good, except for the missing use case you identified, and my fix for which worked on the first try. The irregularity of the page inputs was the tricky bit. At one point I had a fearful episode that I'd misdesigned `MR` for one scenario, and much like the Master being terrorized by the Keller Machine, I had visions of the Doctor (Ingo Schwarze) laughing at me and telling me he told me so and winning the whole world over to mdoc(7) in one stroke. But it was fine (attached). There are _still_ some `ad` requests scattered around (outside of tbl(1) text blocks), but I didn't go after those because they weren't in the way of my objective. Eventually it'd be good to scrub those too. > > I prepared this change with the following GNU sed script. > > > > \# Handle simplest cases: ".BR foo (1)" and ".IR foo (1)". > > What I do to avoid git messing with these comments is to write a > leading space. For git, only '#' in column 1 are special. Since most > compilers and interpreters allow a space before a commented line, a > leading space is fine. Ahh. A leading backslash is the only workaround I've ever noticed. > I've edited the commit message to have spaces, so that it's directly > pastable into a MR.sed script. Oh, and I included "$ cat MR.sed;" in > the commit message; I couldn't not do it. :) No worries. :) > I've applied the patch (or rather, the script), but won't push it yet. > If you send a run of commands that prove no differences before and > after, I'll amend the commit message with it. Please do verify it yourself with the tools above (or better ones). I'm well aware that this is a huge change that can make people nervous. Regards, Branden [-- Attachment #1.2: try-to-break-MR.man --] [-- Type: application/x-troff-man, Size: 461 bytes --] [-- Attachment #2: signature.asc --] [-- Type: application/pgp-signature, Size: 833 bytes --] ^ permalink raw reply [flat|nested] 17+ messages in thread
* Re: [PATCH v2] man*/: ffix (migrate to `MR`) 2023-07-31 22:50 ` G. Branden Robinson @ 2023-07-31 23:15 ` Alejandro Colomar 2023-08-01 20:10 ` G. Branden Robinson 0 siblings, 1 reply; 17+ messages in thread From: Alejandro Colomar @ 2023-07-31 23:15 UTC (permalink / raw) To: G. Branden Robinson; +Cc: linux-man, Ingo Schwarze, Jakub Wilk, groff [-- Attachment #1.1: Type: text/plain, Size: 5473 bytes --] Hi Branden, On 2023-08-01 00:50, G. Branden Robinson wrote: > Hi Alex, > > At 2023-07-31T23:47:50+0200, Alejandro Colomar wrote: >>> When the text of all Linux man-pages documents (excluding those >>> containing only `so` requests) is dumped, with adjustment mode 'l' >>> ("-dAD=l") and automatic hyphenation disabled ("-rHY=0") before and >>> after this change, there is no change to rendered output. >> >> It would be interesting to see a script that corroborates the above >> paragraph. It might help other projects that may want to migrate to >> MR. > > Sure. I used a couple of scripts. > > $ cat ATTIC/dump-pages.sh > #!/bin/sh > > pages=$(grep -L '^\.so ' man*/* | sort) > groff -t "$@" -m andoc -T utf8 -P -cbou $pages > > $ cat ATTIC/dump-pages-left-adjustment-no-hyphenation.sh > #!/bin/sh > > pages=$(grep -L '^\.so ' man*/* | sort) > groff -t -dAD=l -rHY=0 -m andoc -T utf8 -P -cbou $pages > > And here's how I ran them. > > sh ATTIC/dump-pages.sh >| DUMP1 > sed -i -f ./ATTIC/MR.sed $(grep -L '^\.so ' man*/*) > sh ATTIC/dump-pages-left-adjustment-no-hyphenation.sh >| DUMP2 > diff -U0 -b DUMP1 DUMP2 | less -R > > That confirmed that there were "no changes" (with the caveat noted > above). > > sh ATTIC/dump-pages.sh >| DUMP2 > diff -U0 -b DUMP1 DUMP2 | less -R > diff -U0 -b DUMP1 DUMP2 | wc -l > > I used these to eyeball and measure whether there were any formatting > changes even with default adjustment and hyphenation enabled. It showed > me _tons_ of man page names no longer getting broken (and hyphenated) > across lines, and nothing else that I noticed. > > With the previous empty diff in hand, I decided that I hadn't regressed > the text of the pages. > > If there are further sanity checks we can apply, I'm open to > suggestions. Nah, I eyeballed random samples the diff and it looked good. That, and your extensive tests, make me confident enough. If we screwed anything, we can fix it. The only concern I had some time ago was with code like exit(1), but that should be using italics today, so it shouldn't be a problem. I can't imagine big issues. > > Since you had me looking at my shell history, I'll share that I did a > "git co ." (co = alias for "checkout") 18 times in the course of > developing MR.sed. Those drove most of my recent patch submissions > immediately prior to this one. I could have done 18 more without > fatiguing (albeit not necessrily without frustration with myself for not > getting my sed right). But that's the beauty of sed, and > Bash/readline's "reverse-search-history" and "operate-and-get-next" > features. > > As it turned out, my sed was pretty good, except for the missing use > case you identified, and my fix for which worked on the first try. The > irregularity of the page inputs was the tricky bit. > > At one point I had a fearful episode that I'd misdesigned `MR` for one > scenario, and much like the Master being terrorized by the Keller > Machine, I had visions of the Doctor (Ingo Schwarze) laughing at me and > telling me he told me so and winning the whole world over to mdoc(7) in > one stroke. But it was fine (attached). > > There are _still_ some `ad` requests scattered around (outside of tbl(1) > text blocks), but I didn't go after those because they weren't in the > way of my objective. Eventually it'd be good to scrub those too. > >>> I prepared this change with the following GNU sed script. >>> >>> \# Handle simplest cases: ".BR foo (1)" and ".IR foo (1)". >> >> What I do to avoid git messing with these comments is to write a >> leading space. For git, only '#' in column 1 are special. Since most >> compilers and interpreters allow a space before a commented line, a >> leading space is fine. > > Ahh. A leading backslash is the only workaround I've ever noticed. > >> I've edited the commit message to have spaces, so that it's directly >> pastable into a MR.sed script. Oh, and I included "$ cat MR.sed;" in >> the commit message; I couldn't not do it. :) > > No worries. :) > >> I've applied the patch (or rather, the script), but won't push it yet. >> If you send a run of commands that prove no differences before and >> after, I'll amend the commit message with it. > > Please do verify it yourself with the tools above (or better ones). I'm > well aware that this is a huge change that can make people nervous. I applied the patch, amended the message with a quote from this email, and pushed to the MR branch in my private git repo at <http://www.alejandro-colomar.es/src/alx/linux/man-pages/man-pages.git/log/?h=MR>. Oh, and I also removed a few pages from your patch, per CONTRIBUTING guidelines: Notes External and autogenerated pages A few pages come from external sources. Fixes to the pages should really go to the upstream source. tzfile(5), tzselect(8), zdump(8), and zic(8) come from the tz project <https://www.iana.org/time-zones>. bpf-helpers(7) is autogenerated from the Linux kernel sources using scripts. See man-pages commits 53666f6c3 and 19c7f7839 for details. Anyone that wants to check it, feel free to have a look at it. Cheers, Alex > > Regards, > Branden -- <http://www.alejandro-colomar.es/> GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5 [-- Attachment #2: OpenPGP digital signature --] [-- Type: application/pgp-signature, Size: 833 bytes --] ^ permalink raw reply [flat|nested] 17+ messages in thread
* Re: [PATCH v2] man*/: ffix (migrate to `MR`) 2023-07-31 23:15 ` Alejandro Colomar @ 2023-08-01 20:10 ` G. Branden Robinson 2023-08-17 0:14 ` Brian Inglis 0 siblings, 1 reply; 17+ messages in thread From: G. Branden Robinson @ 2023-08-01 20:10 UTC (permalink / raw) To: Alejandro Colomar; +Cc: linux-man, Ingo Schwarze, Jakub Wilk, groff [-- Attachment #1: Type: text/plain, Size: 2121 bytes --] Hi Alex, At 2023-08-01T01:15:02+0200, Alejandro Colomar wrote: > Nah, I eyeballed random samples the diff and it looked good. That, > and your extensive tests, make me confident enough. If we screwed > anything, we can fix it. > > The only concern I had some time ago was with code like exit(1), but > that should be using italics today, so it shouldn't be a problem. I > can't imagine big issues. Well, we'll see how it sits in your 'MR' branch for a while. Maybe we can recruit some beta testers. > > Please do verify it yourself with the tools above (or better ones). > > I'm well aware that this is a huge change that can make people > > nervous. > > I applied the patch, amended the message with a quote from this email, > and pushed to the MR branch in my private git repo at > <http://www.alejandro-colomar.es/src/alx/linux/man-pages/man-pages.git/log/?h=MR>. I saw. Thanks! > Oh, and I also removed a few pages from your patch, per CONTRIBUTING > guidelines: > > Notes > External and autogenerated pages > A few pages come from external sources. Fixes to the pages > should really go to the upstream source. > > tzfile(5), tzselect(8), zdump(8), and zic(8) come from the tz > project <https://www.iana.org/time-zones>. > > bpf-helpers(7) is autogenerated from the Linux kernel sources > using scripts. See man-pages commits 53666f6c3 and 19c7f7839 for > details. Right, thank you. I completely zoned about those. Unfortunately none of the time zone pages offer any hint I can see that they're autogenerated, so (short of hard-coding a list), they can't be automatically excluded from global changes. bpf-helpers does announce that it's produced by rst2man (without naming the tool explicitly). The good news is that I've started to have a look at how rst2man works. Dmitry Schachnev of the Debian Python team was really helpful in this area. I've poked and prodded it a bit. Found some gaps. I'm afraid I might horrify Engelbert Gruber, the upstream maintainer. Regards, Branden [-- Attachment #2: signature.asc --] [-- Type: application/pgp-signature, Size: 833 bytes --] ^ permalink raw reply [flat|nested] 17+ messages in thread
* Re: [PATCH v2] man*/: ffix (migrate to `MR`) 2023-08-01 20:10 ` G. Branden Robinson @ 2023-08-17 0:14 ` Brian Inglis 0 siblings, 0 replies; 17+ messages in thread From: Brian Inglis @ 2023-08-17 0:14 UTC (permalink / raw) To: linux-man; +Cc: alx, g.branden.robinson On Tue, 1 Aug 2023 15:10:00 -0500, G. Branden Robinson wrote > At 2023-08-01T01:15:02+0200, Alejandro Colomar wrote: >> tzfile(5), tzselect(8), zdump(8), and zic(8) come from the tz project >> <https://www.iana.org/time-zones>. >> >> bpf-helpers(7) is autogenerated from the Linux kernel sources > Unfortunately none of the time zone pages offer any hint I can see that > they're autogenerated, so (short of hard-coding a list), they can't be > automatically excluded from global changes. Those man pages plus time2posix(3) are all prefixed with ADO's PD declaration with one of two dates: .\" This file is in the public domain, so clarified as of .\" 1996-06-05|2009-05-17 by Arthur David Olson. and are maintained in https://github.com/eggert/tz/ so the files are available directly from .../{blame,blob,commits,raw}/main/... I do not know gitmodules well enough to say whether you could add that as a subrepo then gitignore everything but the man pages you want to include. -- Take care. Thanks, Brian Inglis Calgary, Alberta, Canada La perfection est atteinte Perfection is achieved non pas lorsqu'il n'y a plus rien à ajouter not when there is no more to add mais lorsqu'il n'y a plus rien à retirer but when there is no more to cut -- Antoine de Saint-Exupéry ^ permalink raw reply [flat|nested] 17+ messages in thread
* Re: [PATCH v2] man*/: ffix (migrate to `MR`) 2023-07-31 17:52 [PATCH v2] man*/: ffix (migrate to `MR`) G. Branden Robinson 2023-07-31 21:47 ` Alejandro Colomar @ 2023-07-31 22:16 ` Jakub Wilk 2023-07-31 23:30 ` Alejandro Colomar 2023-08-01 1:31 ` G. Branden Robinson 1 sibling, 2 replies; 17+ messages in thread From: Jakub Wilk @ 2023-07-31 22:16 UTC (permalink / raw) To: G. Branden Robinson; +Cc: Alejandro Colomar, linux-man * G. Branden Robinson <g.branden.robinson@gmail.com>, 2023-07-31 12:52: >Use the man(7) macro `MR`, new to groff 1.23.0, Given that this version of groff was released approximately yesterday¹, this is very premature. NACK from me. >When the text of all Linux man-pages documents (excluding those >containing only `so` requests) is dumped, with adjustment mode 'l' >("-dAD=l") and automatic hyphenation disabled ("-rHY=0") before and >after this change, there is no change to rendered output. That's not what I'm seeing with Debian groff 1.22.4-10 (which seems to have .MR backported). After applying the patch, the man page references are typeset in italics, which is ugly and against man-pages(7) recommendations. ¹ More precisely, about a month ago. -- Jakub Wilk ^ permalink raw reply [flat|nested] 17+ messages in thread
* Re: [PATCH v2] man*/: ffix (migrate to `MR`) 2023-07-31 22:16 ` Jakub Wilk @ 2023-07-31 23:30 ` Alejandro Colomar 2023-08-01 1:31 ` G. Branden Robinson 1 sibling, 0 replies; 17+ messages in thread From: Alejandro Colomar @ 2023-07-31 23:30 UTC (permalink / raw) To: Jakub Wilk, G. Branden Robinson; +Cc: linux-man, groff, Ingo Schwarze [-- Attachment #1.1: Type: text/plain, Size: 3606 bytes --] Hi Jakub, Branden, Ingo On 2023-08-01 00:16, Jakub Wilk wrote: > * G. Branden Robinson <g.branden.robinson@gmail.com>, 2023-07-31 12:52: >> Use the man(7) macro `MR`, new to groff 1.23.0, > > Given that this version of groff was released approximately yesterday¹, > this is very premature. > > NACK from me. I included that, and the reason, in the commit message. It's in the MR branch in my private repo, as I mentioned in a reply to Branden: <http://www.alejandro-colomar.es/src/alx/linux/man-pages/man-pages.git/log/?h=MR> My server is HTTP-only, but the commit should be signed with my PGP signature, so it should be safe to check anything from my git: $ git show --pretty=fuller --show-signature commit d4a22d4645184c205a04477ee84b0ee429fb6200 (HEAD -> MR, alx/MR) gpg: Signature made Tue Aug 1 01:19:00 2023 CEST gpg: using RSA key EA3A87F0A4EBA030E45DF2409E8C1AFBBEFFDB32 gpg: Good signature from "Alejandro Colomar <alx@kernel.org>" [ultimate] gpg: aka "Alejandro Colomar Andres <alx.manpages@gmail.com>" [ultimate] Author: G. Branden Robinson <g.branden.robinson@gmail.com> AuthorDate: Mon Jul 31 12:52:51 2023 -0500 Commit: Alejandro Colomar <alx@kernel.org> CommitDate: Tue Aug 1 01:18:59 2023 +0200 man*/: ffix (migrate to `MR`) [...] Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com> [Jakub has concerns that groff-1.23.0 was released too recently] Nacked-by: Jakub Wilk <jwilk@jwilk.net> [alx: Added quote from gbr documenting how he tested for regressions] Signed-off-by: Alejandro Colomar <alx@kernel.org> (While preparing this email, I noticed I hadn't noted Branden's authorship while committing, so I've amended the commit; luckily it wasn't on kernel.org. I'm sorry if I caused any inconvenience to anyone fetching from my repo.) > >> When the text of all Linux man-pages documents (excluding those >> containing only `so` requests) is dumped, with adjustment mode 'l' >> ("-dAD=l") and automatic hyphenation disabled ("-rHY=0") before and >> after this change, there is no change to rendered output. > > That's not what I'm seeing with Debian groff 1.22.4-10 (which seems to > have .MR backported). > > After applying the patch, the man page references are typeset in > italics, which is ugly and against man-pages(7) recommendations. I guess he meant no regressions other than the intended formatting change. Branden, I find that this isn't really documented in the commit message and it should be. We probably thought it was obvious, but Jakub is right there. I would be worried if there would remain any difference after removing formatting, or more precisely, if after configuring MR to do bold there would remain any differences. However: Branden, I suggest you content Jakub showing more proof that there's no regressions, and very explicitly document the intentional regressions a bit more (basically that we're changing to italics). Jakub, you (or distributors) can always change the meaning of MR to perform bold instead of italics. Just in case you didn't know. Although if you didn't, maybe it's a sign that it should be more thoroughly documented in this patch. I started CCing Ingo in these discussions to let him know that D-day has come, and we would appreciate mandoc(1) support for `MR`. Cheers, Alex > > > ¹ More precisely, about a month ago. > -- <http://www.alejandro-colomar.es/> GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5 [-- Attachment #2: OpenPGP digital signature --] [-- Type: application/pgp-signature, Size: 833 bytes --] ^ permalink raw reply [flat|nested] 17+ messages in thread
* Re: [PATCH v2] man*/: ffix (migrate to `MR`) 2023-07-31 22:16 ` Jakub Wilk 2023-07-31 23:30 ` Alejandro Colomar @ 2023-08-01 1:31 ` G. Branden Robinson 2023-08-01 13:35 ` Alejandro Colomar 1 sibling, 1 reply; 17+ messages in thread From: G. Branden Robinson @ 2023-08-01 1:31 UTC (permalink / raw) To: Jakub Wilk; +Cc: Alejandro Colomar, linux-man [-- Attachment #1: Type: text/plain, Size: 3970 bytes --] Hi Jakub, At 2023-08-01T00:16:41+0200, Jakub Wilk wrote: > * G. Branden Robinson <g.branden.robinson@gmail.com>, 2023-07-31 12:52: > > Use the man(7) macro `MR`, new to groff 1.23.0, > > Given that this version of groff was released approximately > yesterday¹, this is very premature. > > NACK from me. > > ¹ More precisely, about a month ago. 5 July UTC, to be (a little) more precise. Linux man-pages release scheduling is Alex's prerogative, not mine. He asked me (a long time ago) to deliver this after groff 1.23.0 was released. That is what I have tried to do. > > When the text of all Linux man-pages documents (excluding those > > containing only `so` requests) is dumped, with adjustment mode 'l' > > ("-dAD=l") and automatic hyphenation disabled ("-rHY=0") before and > > after this change, there is no change to rendered output. > > That's not what I'm seeing with Debian groff 1.22.4-10 (which seems to > have .MR backported). Not exactly. It has a compatible stopgap measure to keep Debian stable from going wrong in the event that any package using `MR` in its man pages gets backported to bookworm (Debian 12). https://salsa.debian.org/debian/groff/-/merge_requests/4 groff 1.22.4 man(7) does not support the `MF` string (see below). That could be backported too, but there seems no point before there is a concrete need. > After applying the patch, the man page references are typeset in > italics, For great justice! (See below.) > which is ugly See my recent exchanges with Lennart Jablonka on this list. > and against man-pages(7) recommendations. Not all man pages are bound by man-pages(7) style suggestions. Further, /etc/groff/man.local is a conffile, and assuming it's stock (to simplify the pattern matching below), you can do this: sed -i -e 's/IR/BR/' /etc/groff/man.local And that way, even if someone backports groff 1.23.0 itself to Debian stable, you will not be disturbed by the choice of font for man page cross references. It might be helpful to recap the `MR` feature description from the 1.23.0 NEWS file and release announcement. One of its objectives is to _stop_ prescribing a typeface for these things, though of course it has a default, as it must. o The an (man) macro package supports a new macro, `MR`, intended for use by man page cross references in preference to the font style alternation macros historically used. Where before you would write .BR ls (1). or .IR ls (1). you should now write .MR ls 1 . (the third argument, typically used for trailing punctuation, is optional). Because the macro semantically identifies a man page, it can create a clickable hyperlink ("man:ls(1)" for the above example) on supporting devices. Furthermore, a new string, `MF`, defines the font to be used for setting the man page topic (the first argument to `MR` and `TH`), permitting configuration by distributions, sites, and users. Inclusion of the `MR` macro was prompted by its introduction to Plan 9 from User Space's troff in August 2020. Its purpose is to ameliorate several long-standing problems with man page cross references: (1) the package's lack of inherent hyperlink support for them; (2) false-positive identification of strings resembling man page cross references (as can happen with "exit(1)", "while(1)", "sleep(5)", "time(0)" and others) by terminal emulators and other programs; (3) the unwanted intrusion of hyphens into man page topics, which frustrates copy-and-paste operations (this problem has always been avoidable through use of the \% escape sequence, but cross references are frequent in man pages and some page authors are inexpert *roff users); and (4) deep divisions in man page maintenance communities over which typeface should be used to set the man page topic (italics, roman, or bold). Regards, Branden [-- Attachment #2: signature.asc --] [-- Type: application/pgp-signature, Size: 833 bytes --] ^ permalink raw reply [flat|nested] 17+ messages in thread
* Re: [PATCH v2] man*/: ffix (migrate to `MR`) 2023-08-01 1:31 ` G. Branden Robinson @ 2023-08-01 13:35 ` Alejandro Colomar 2023-08-01 14:12 ` G. Branden Robinson 0 siblings, 1 reply; 17+ messages in thread From: Alejandro Colomar @ 2023-08-01 13:35 UTC (permalink / raw) To: G. Branden Robinson, Jakub Wilk; +Cc: linux-man, groff [-- Attachment #1.1: Type: text/plain, Size: 3468 bytes --] [CC += groff] Hi Jakub, Branden, On 2023-08-01 03:31, G. Branden Robinson wrote: > Hi Jakub, > > At 2023-08-01T00:16:41+0200, Jakub Wilk wrote: >> * G. Branden Robinson <g.branden.robinson@gmail.com>, 2023-07-31 12:52: >>> Use the man(7) macro `MR`, new to groff 1.23.0, >> >> Given that this version of groff was released approximately >> yesterday¹, this is very premature. >> >> NACK from me. >> >> ¹ More precisely, about a month ago. > > 5 July UTC, to be (a little) more precise. > > Linux man-pages release scheduling is Alex's prerogative, not mine. I just made a new release, so that we have plenty of time for the next one. I don't expect to make a new one in months. :) > He > asked me (a long time ago) to deliver this after groff 1.23.0 was > released. That is what I have tried to do. Thanks! > >>> When the text of all Linux man-pages documents (excluding those >>> containing only `so` requests) is dumped, with adjustment mode 'l' >>> ("-dAD=l") and automatic hyphenation disabled ("-rHY=0") before and >>> after this change, there is no change to rendered output. >> >> That's not what I'm seeing with Debian groff 1.22.4-10 (which seems to >> have .MR backported). > > Not exactly. It has a compatible stopgap measure to keep Debian stable > from going wrong in the event that any package using `MR` in its man > pages gets backported to bookworm (Debian 12). > > https://salsa.debian.org/debian/groff/-/merge_requests/4 Yep; probably the most relevant case is contributors to this project using Debian Stable to produce write their patches. > > groff 1.22.4 man(7) does not support the `MF` string (see below). That > could be backported too, but there seems no point before there is a > concrete need. > >> After applying the patch, the man page references are typeset in >> italics, > > For great justice! (See below.) Still I think this should be documented in our commit. Would you please send a paragraph (and the position at which you'd place it) with which I can amend the commit? > >> which is ugly > > See my recent exchanges with Lennart Jablonka on this list. > >> and against man-pages(7) recommendations. Well, we should update those to use MR. Branden is right that italics is more appropriate. He has defended that position very well, so I'll let him defend that point. The conversation to which he referred was: <https://lists.gnu.org/archive/html/groff/2021-08/msg00034.html> > > Not all man pages are bound by man-pages(7) style suggestions. > > Further, /etc/groff/man.local is a conffile, and assuming it's stock (to > simplify the pattern matching below), you can do this: > > sed -i -e 's/IR/BR/' /etc/groff/man.local > > And that way, even if someone backports groff 1.23.0 itself to Debian > stable, you will not be disturbed by the choice of font for man page > cross references. > > It might be helpful to recap the `MR` feature description from the > 1.23.0 NEWS file and release announcement. One of its objectives is to > _stop_ prescribing a typeface for these things, though of course it has > a default, as it must. But we should document in the commit message that the MR default implies a behavior change in our pages. Cheers, Alex > > Regards, > Branden -- <http://www.alejandro-colomar.es/> GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5 [-- Attachment #2: OpenPGP digital signature --] [-- Type: application/pgp-signature, Size: 833 bytes --] ^ permalink raw reply [flat|nested] 17+ messages in thread
* Re: [PATCH v2] man*/: ffix (migrate to `MR`) 2023-08-01 13:35 ` Alejandro Colomar @ 2023-08-01 14:12 ` G. Branden Robinson 2023-08-12 15:35 ` Alejandro Colomar 0 siblings, 1 reply; 17+ messages in thread From: G. Branden Robinson @ 2023-08-01 14:12 UTC (permalink / raw) To: Alejandro Colomar; +Cc: Jakub Wilk, linux-man, groff [-- Attachment #1: Type: text/plain, Size: 5186 bytes --] At 2023-08-01T15:35:10+0200, Alejandro Colomar wrote: > [CC += groff] > > Hi Jakub, Branden, > > On 2023-08-01 03:31, G. Branden Robinson wrote: > > Hi Jakub, > > > > At 2023-08-01T00:16:41+0200, Jakub Wilk wrote: > >> * G. Branden Robinson <g.branden.robinson@gmail.com>, 2023-07-31 12:52: > >>> Use the man(7) macro `MR`, new to groff 1.23.0, > >> > >> Given that this version of groff was released approximately > >> yesterday¹, this is very premature. > >> > >> NACK from me. > >> > >> ¹ More precisely, about a month ago. > > > > 5 July UTC, to be (a little) more precise. > > > > Linux man-pages release scheduling is Alex's prerogative, not mine. > > I just made a new release, so that we have plenty of time for the next > one. I saw that, and thought, "ooh, that's a bit quick--surely he didn't..." And no, you didn't (include the giant `MR` migration patch). I trust the announcement didn't give Jakub a heart attack... > I don't expect to make a new one in months. :) I can't cast stones about release frequency, that's for sure. > > He asked me (a long time ago) to deliver this after groff 1.23.0 was > > released. That is what I have tried to do. > > Thanks! A pleasure. Not merely to promulgate my "baby", but also to get a lot of that cargo-culty stuff around tables cleaned out of the Linux man-pages. Tidy man(7) sources make for happier documentation writers who have an easier time getting what they want. > > groff 1.22.4 man(7) does not support the `MF` string (see below). > > That could be backported too, but there seems no point before there > > is a concrete need. > > > >> After applying the patch, the man page references are typeset in > >> italics, > > > > For great justice! (See below.) > > Still I think this should be documented in our commit. Would you > please send a paragraph (and the position at which you'd place it) > with which I can amend the commit? Yes. That was on oversight on my part; I was scrubbing out all font changes (with "-P -cbou") because my concern was with unexpected changes to adjustment and hyphenation. The style change for man page topics (from bold to italics) was a "known factor" (to me). Also, I saw that some "=3D" quoted-printable ugliness got into the commit message, buried inside groff command-line options where people unaccustomed to writing them might not mentally screen out the noise. Please double-check for that before pushing to kernel.org. > >> which is ugly > > > > See my recent exchanges with Lennart Jablonka on this list. > > > >> and against man-pages(7) recommendations. > > Well, we should update those to use MR. And man(7) too, I guess. What do you think? > Branden is right that italics is more appropriate. He has defended > that position very well, so I'll let him defend that point. The > conversation to which he referred was: > > <https://lists.gnu.org/archive/html/groff/2021-08/msg00034.html> Yes. That message includes Ingo's acknowledgement of my historical analysis, which can be found in the parent message. https://lists.gnu.org/archive/html/groff/2021-08/msg00023.html But we had a fairly wide-ranging discussion, much of which will not be of interest to someone who updates to man-pages 6.6.6 🤘, sees italics appearing where they had been accustomed to bold, and flies into a rage. I reckon the virtuous thing to do would be to write an ms(7) article about the history of cross reference styling in Unix man pages. I regret that my conjecture about _why_ the GNU/Linux community shifted the style (VGA text mode limitations) remains unsupported by testimonial accounts from people who deliberately made this change. Maybe this change will attract the attention of those folks. Even if they get angry with me in the process, I'm willing to risk being called out as the price of improving the historical record. :) > But we should document in the commit message that the MR default > implies a behavior change in our pages. Yes. And it's not hard to offer MANROFFOPT="-dMF=B" as an initial workaround. One could throw this into one's shell startup file, but only man-db man(1) honors that variable. The more systemic approach is to edit the site configuration file for groff man(7). Files [...] /usr/share/groff/site-tmac/man.local Local changes and customizations should be put into this file. (Debian symlinks this to "/etc/groff/man.local".) groff_man_style(7) offers further suggestions for content, based (mostly) on feedback we've often seen over the years. .\" Use narrower indentation on terminals and similar. .if n .nr IN 4n .\" Put only one space after the end of a sentence. .ss 12 0 \" See groff(7). .\" Keep pages narrow even on wide terminals. .if n .if \n[LL]>78n .nr LL 78n .\" Ensure hyperlinks are enabled for terminals. .nr U 1 Debian's groff 1.23.0 packages in testing and unstable in fact already enable the last (thanks, Colin!). Regards, Branden [-- Attachment #2: signature.asc --] [-- Type: application/pgp-signature, Size: 833 bytes --] ^ permalink raw reply [flat|nested] 17+ messages in thread
* Re: [PATCH v2] man*/: ffix (migrate to `MR`) 2023-08-01 14:12 ` G. Branden Robinson @ 2023-08-12 15:35 ` Alejandro Colomar 2023-08-16 3:55 ` G. Branden Robinson 0 siblings, 1 reply; 17+ messages in thread From: Alejandro Colomar @ 2023-08-12 15:35 UTC (permalink / raw) To: Ingo Schwarze, Jakub Wilk, G. Branden Robinson; +Cc: linux-man, groff [-- Attachment #1.1: Type: text/plain, Size: 6235 bytes --] Hi Branden, Ingo, On 2023-08-01 16:12, G. Branden Robinson wrote: > At 2023-08-01T15:35:10+0200, Alejandro Colomar wrote: >> [CC += groff] >> >> Hi Jakub, Branden, >> >> On 2023-08-01 03:31, G. Branden Robinson wrote: >>> Hi Jakub, >>> >>> At 2023-08-01T00:16:41+0200, Jakub Wilk wrote: >>>> * G. Branden Robinson <g.branden.robinson@gmail.com>, 2023-07-31 12:52: >>>>> Use the man(7) macro `MR`, new to groff 1.23.0, >>>> >>>> Given that this version of groff was released approximately >>>> yesterday¹, this is very premature. >>>> >>>> NACK from me. >>>> >>>> ¹ More precisely, about a month ago. >>> >>> 5 July UTC, to be (a little) more precise. >>> >>> Linux man-pages release scheduling is Alex's prerogative, not mine. >> >> I just made a new release, so that we have plenty of time for the next >> one. > > I saw that, and thought, "ooh, that's a bit quick--surely he didn't..." > > And no, you didn't (include the giant `MR` migration patch). Not yet. I hope to have MR support in mandoc(1) before I release that. Ingo, would you mind? :) > > I trust the announcement didn't give Jakub a heart attack... > >> I don't expect to make a new one in months. :) > > I can't cast stones about release frequency, that's for sure. > >>> He asked me (a long time ago) to deliver this after groff 1.23.0 was >>> released. That is what I have tried to do. >> >> Thanks! > > A pleasure. Not merely to promulgate my "baby", but also to get a lot > of that cargo-culty stuff around tables cleaned out of the Linux > man-pages. Tidy man(7) sources make for happier documentation writers > who have an easier time getting what they want. Yup! > >>> groff 1.22.4 man(7) does not support the `MF` string (see below). >>> That could be backported too, but there seems no point before there >>> is a concrete need. >>> >>>> After applying the patch, the man page references are typeset in >>>> italics, >>> >>> For great justice! (See below.) >> >> Still I think this should be documented in our commit. Would you >> please send a paragraph (and the position at which you'd place it) >> with which I can amend the commit? > > Yes. That was on oversight on my part; I was scrubbing out all font > changes (with "-P -cbou") because my concern was with unexpected changes > to adjustment and hyphenation. The style change for man page topics > (from bold to italics) was a "known factor" (to me). Would you mind sending an updated commit message? > > Also, I saw that some "=3D" quoted-printable ugliness got into the > commit message, buried inside groff command-line options where people > unaccustomed to writing them might not mentally screen out the noise. Heh, I noticed some weirdness about it, but it happened to be after a -rCHECKSTYLE, so it seemed like it could be some improvements that you had applied upstream to CHECKSTYLE. =3 definitely made sense to that register. > > Please double-check for that before pushing to kernel.org. Please send one that I don't need to modify. I don't like modifying other's stuff, in case I break it. :) > >>>> which is ugly >>> >>> See my recent exchanges with Lennart Jablonka on this list. >>> >>>> and against man-pages(7) recommendations. >> >> Well, we should update those to use MR. > > And man(7) too, I guess. What do you think? I want to kill that page. Please have a look at it, take anything good that it has for groff_man{,_style}(7), and ping me when I should sharpen the scythe. ;) Cheers, Alex > >> Branden is right that italics is more appropriate. He has defended >> that position very well, so I'll let him defend that point. The >> conversation to which he referred was: >> >> <https://lists.gnu.org/archive/html/groff/2021-08/msg00034.html> > > Yes. That message includes Ingo's acknowledgement of my historical > analysis, which can be found in the parent message. > > https://lists.gnu.org/archive/html/groff/2021-08/msg00023.html > > But we had a fairly wide-ranging discussion, much of which will not be > of interest to someone who updates to man-pages 6.6.6 🤘, sees italics > appearing where they had been accustomed to bold, and flies into a rage. > > I reckon the virtuous thing to do would be to write an ms(7) article > about the history of cross reference styling in Unix man pages. I > regret that my conjecture about _why_ the GNU/Linux community shifted > the style (VGA text mode limitations) remains unsupported by testimonial > accounts from people who deliberately made this change. > > Maybe this change will attract the attention of those folks. Even if > they get angry with me in the process, I'm willing to risk being called > out as the price of improving the historical record. :) > >> But we should document in the commit message that the MR default >> implies a behavior change in our pages. > > Yes. And it's not hard to offer MANROFFOPT="-dMF=B" as an initial > workaround. One could throw this into one's shell startup file, but > only man-db man(1) honors that variable. The more systemic approach is > to edit the site configuration file for groff man(7). > > Files > [...] > /usr/share/groff/site-tmac/man.local > Local changes and customizations should be put into this file. > > (Debian symlinks this to "/etc/groff/man.local".) > > groff_man_style(7) offers further suggestions for content, based > (mostly) on feedback we've often seen over the years. > > .\" Use narrower indentation on terminals and similar. > .if n .nr IN 4n > .\" Put only one space after the end of a sentence. > .ss 12 0 \" See groff(7). > .\" Keep pages narrow even on wide terminals. > .if n .if \n[LL]>78n .nr LL 78n > .\" Ensure hyperlinks are enabled for terminals. > .nr U 1 > > Debian's groff 1.23.0 packages in testing and unstable in fact already > enable the last (thanks, Colin!). > > Regards, > Branden -- <http://www.alejandro-colomar.es/> GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5 [-- Attachment #2: OpenPGP digital signature --] [-- Type: application/pgp-signature, Size: 833 bytes --] ^ permalink raw reply [flat|nested] 17+ messages in thread
* Re: [PATCH v2] man*/: ffix (migrate to `MR`) 2023-08-12 15:35 ` Alejandro Colomar @ 2023-08-16 3:55 ` G. Branden Robinson 2023-08-16 12:12 ` Alejandro Colomar 2023-08-16 16:33 ` Ingo Schwarze 0 siblings, 2 replies; 17+ messages in thread From: G. Branden Robinson @ 2023-08-16 3:55 UTC (permalink / raw) To: Alejandro Colomar; +Cc: linux-man, groff [-- Attachment #1: Type: text/plain, Size: 2924 bytes --] [dropped Ingo, Jakub] Hi Alex, At 2023-08-12T17:35:32+0200, Alejandro Colomar wrote: > On 2023-08-01 16:12, G. Branden Robinson wrote: > > At 2023-08-01T15:35:10+0200, Alejandro Colomar wrote: > >> Still I think this should be documented in our commit. Would you > >> please send a paragraph (and the position at which you'd place it) > >> with which I can amend the commit? > > > > Yes. That was on oversight on my part; I was scrubbing out all font > > changes (with "-P -cbou") because my concern was with unexpected > > changes to adjustment and hyphenation. The style change for man > > page topics (from bold to italics) was a "known factor" (to me). > > Would you mind sending an updated commit message? I did, but you found a fresh problem, this time with part 1, so I guess we'll be going to v4! :-O Also I'm going to make an attempt to drive the part 1 change with sed as well. Just to see if I can, and to see what happens. > Heh, I noticed some weirdness about it, but it happened to be after a > -rCHECKSTYLE, so it seemed like it could be some improvements that you > had applied upstream to CHECKSTYLE. =3 definitely made sense to that > register. GNU troff(1) does not raise a diagnostic if a register assignment is followed by garbage. That's disappointing. Filed. https://savannah.gnu.org/bugs/?64559 > > Please double-check for that before pushing to kernel.org. > > Please send one that I don't need to modify. I don't like modifying > other's stuff, in case I break it. :) Did v3 2/2 show up for you without quoted-printable damage? > >>>> and against man-pages(7) recommendations. > >> > >> Well, we should update those to use MR. > > > > And man(7) too, I guess. What do you think? > > I want to kill that page. Please have a look at it, take anything > good that it has for groff_man{,_style}(7), and ping me when I > should sharpen the scythe. ;) Ok, will do. If the page is withdrawn, I expect distributors will need to manage the man.7 page using Debian's "alternatives" mechanism or similar; if groff_man.7 is installed, man.7 should be a symlink to it. If mandoc_man.7 is installed, likewise. If both are installed, the distributor needs to select a default preference. I expect you will want to emphasize this in the release announcement, when the time comes. This already needs to happen with soelim(1) and roff(7), but it doesn't, exactly; Debian renames mandoc's versions of the former to msoelim(1) and the latter to mandoc_roff(1). Termux simply throws groff's versions away and installs mandoc's versions as soelim(1) and roff(7). I also use Termux. Imagine my surprise when I upgraded to groff 1.23.0 on my tablet and brought up roff(7). I was expecting to see myself in the mirror, and what should greet me but the visage of Ingo Schwarze! Unnerving, no? Regards, Branden [-- Attachment #2: signature.asc --] [-- Type: application/pgp-signature, Size: 833 bytes --] ^ permalink raw reply [flat|nested] 17+ messages in thread
* Re: [PATCH v2] man*/: ffix (migrate to `MR`) 2023-08-16 3:55 ` G. Branden Robinson @ 2023-08-16 12:12 ` Alejandro Colomar 2023-08-16 16:33 ` Ingo Schwarze 1 sibling, 0 replies; 17+ messages in thread From: Alejandro Colomar @ 2023-08-16 12:12 UTC (permalink / raw) To: G. Branden Robinson; +Cc: linux-man, groff [-- Attachment #1.1: Type: text/plain, Size: 3197 bytes --] Hi Branden, On 2023-08-16 05:55, G. Branden Robinson wrote: [...] >> Would you mind sending an updated commit message? > > I did, but you found a fresh problem, this time with part 1, so I guess > we'll be going to v4! :-O Also I'm going to make an attempt to drive > the part 1 change with sed as well. Just to see if I can, and to see > what happens. Great! (As long as it's kept as a separate patch. ;) > >> Heh, I noticed some weirdness about it, but it happened to be after a >> -rCHECKSTYLE, so it seemed like it could be some improvements that you >> had applied upstream to CHECKSTYLE. =3 definitely made sense to that >> register. > > GNU troff(1) does not raise a diagnostic if a register assignment is > followed by garbage. That's disappointing. > > Filed. https://savannah.gnu.org/bugs/?64559 Nice. > >>> Please double-check for that before pushing to kernel.org. >> >> Please send one that I don't need to modify. I don't like modifying >> other's stuff, in case I break it. :) > > Did v3 2/2 show up for you without quoted-printable damage? Yup. I assume Thunderbird is not messing with the source of the received email. I bet it's neomutt(1), even if I'd expect it's not the kind of program that would do that. Please send a hand-crafted encrypted copy in an attached file, where no program can mess with it. > >>>>>> and against man-pages(7) recommendations. >>>> >>>> Well, we should update those to use MR. >>> >>> And man(7) too, I guess. What do you think? >> >> I want to kill that page. Please have a look at it, take anything >> good that it has for groff_man{,_style}(7), and ping me when I >> should sharpen the scythe. ;) > > Ok, will do. > > If the page is withdrawn, I expect distributors will need to manage the > man.7 page using Debian's "alternatives" mechanism or similar; if > groff_man.7 is installed, man.7 should be a symlink to it. If > mandoc_man.7 is installed, likewise. If both are installed, the > distributor needs to select a default preference. > > I expect you will want to emphasize this in the release announcement, > when the time comes. Sure. 6.6 will be a big release. Maybe there are many bug-fix patches to it... like 6? > > This already needs to happen with soelim(1) and roff(7), but it doesn't, > exactly; Debian renames mandoc's versions of the former to msoelim(1) > and the latter to mandoc_roff(1). Termux simply throws groff's versions > away and installs mandoc's versions as soelim(1) and roff(7). > > I also use Termux. This reminds me I need to ping for the replacement of my Linux phone, which has issues, and I can't receive calls. :| > Imagine my surprise when I upgraded to groff 1.23.0 > on my tablet and brought up roff(7). I was expecting to see myself in > the mirror, and what should greet me but the visage of Ingo Schwarze! Huh! Under what criteria do they choose mandoc_roff(7) as /the/ roff(7)? > > Unnerving, no? It is! Cheers, Alex > > Regards, > Branden -- <http://www.alejandro-colomar.es/> GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5 [-- Attachment #2: OpenPGP digital signature --] [-- Type: application/pgp-signature, Size: 833 bytes --] ^ permalink raw reply [flat|nested] 17+ messages in thread
* Re: [PATCH v2] man*/: ffix (migrate to `MR`) 2023-08-16 3:55 ` G. Branden Robinson 2023-08-16 12:12 ` Alejandro Colomar @ 2023-08-16 16:33 ` Ingo Schwarze 2023-08-16 18:25 ` Alejandro Colomar 1 sibling, 1 reply; 17+ messages in thread From: Ingo Schwarze @ 2023-08-16 16:33 UTC (permalink / raw) To: G. Branden Robinson; +Cc: Alejandro Colomar, linux-man, groff Hi Branden, G. Branden Robinson wrote on Tue, Aug 15, 2023 at 10:55:22PM -0500: > If the page is withdrawn, I expect distributors will need to manage the > man.7 page using Debian's "alternatives" mechanism or similar; if > groff_man.7 is installed, man.7 should be a symlink to it. If > mandoc_man.7 is installed, likewise. If both are installed, the > distributor needs to select a default preference. I think that most general-purpose Linux distributions are probably better off simply prefering groff_man.7 over the man.7 bundled with mandoc. As you know, the mandoc distribution regards the man(7) language as a legacy language that is obsolete since about 1990 - which makes sense for all operating systems based on BSD and Illumos. Consequently, the mandoc man(7) page only provides bare-bone information focussing on questions of compatibily and no advice whatsoever for people intending to write new manual pages. That perspective is not really helpful for general purpose Linux distributions: for these, the Linux man-pages project matters a lot, and that project is not considering the man(7) language as obsolete at all. That i keep recommending changing that stance does not appear to have much effect so far and isn't relevant for the questions at hand. Either war, a disagreement regarding the merits of some policy is not a good reason to deprive users of information they might require. > I expect you will want to emphasize this in the release announcement, > when the time comes. In the Linux man-pages project release announcement, i recommend simply saying that groff_man(7) replaces the former man(7) that used to be bundled in the Linux man-pages project. For the purposes of the Linux man-pages project, the man(7) page distributed with mandoc isn't useful, so no need to confuse the users of the Linux man-pages project by talking about it. > This already needs to happen with soelim(1) and roff(7), I'm not convinced. The soelim(1) bundled with mandoc is really only a stopgap implementation in case people need something quickly but don't have a real ROFF system around. I don't think it sees much use at all. For the roff(7) manual page bundled with mandoc, the same applies as for man(7), only more strongly so. The mandoc roff(7) page is totally inadequate for learning the roff language. It merely intends to document the subset of roff(7) relevant for manual page authors and maintainers, and the subset supported by mandoc. > but it doesn't, exactly; Debian renames mandoc's versions of the > former to msoelim(1) and the latter to mandoc_roff(1). That makes sense to me, more than using "alternatives" for these two would, in the case of Debian. I'm not sure installing the mandoc soelim program on Debian is even useful in the first place. If you really need soelim(1) on Debian, you almost certainly already have groff(1) installed, or at least you ought to install it. > Termux simply throws groff's versions > away and installs mandoc's versions as soelim(1) and roff(7). That also makes some sense to me. In Termux, the complete subsystem for searching, displaying, and viewing manual pages has been exclusively based on mandoc since 2015. So while Termux is, in most aspects, more similar to a Linux distro than to a BSD system, regarding documentation, it is essentially a BSD and not a Linux system, so it totally makes sense to follow BSD conventions regarding manual page naming, installation, and manual page tools. Besides, it is a system for relatively small devices, and consequently, the decision to use BSD tools for documentation actually makes sense because the mandoc toolchain is significantly less resource- hungry than the groff toolchain. Of course, mandoc is inadequate for general-purpose typographic and publishing work - but who in their right mind would want to write their books and journal articles on Termux anyway? A small number of other Linux systems exist where similar arguments apply, most notably Alpine Linux and Void Linux. Alpine is heavily geared towards very small hardware. Void is among the Linux distros closest to BSD in philosophy. Both have been using mandoc exclusively for even longer than Termux. But even for Linux distros officially supporting that users switch their manual page search and display system from man-db+groff to mandoc if they want to - last time i looked, that included Arch, openSUSE, and Fedora - installing the mandoc roff(7) as roff(7) would seem like a bad idea to me. > I also use Termux. Imagine my surprise when I upgraded to groff 1.23.0 > on my tablet and brought up roff(7). I was expecting to see myself in > the mirror, and what should greet me but the visage of Ingo Schwarze! > > Unnerving, no? Heh, buhuuu! <evil grin> Yours, Ingo ^ permalink raw reply [flat|nested] 17+ messages in thread
* Re: [PATCH v2] man*/: ffix (migrate to `MR`) 2023-08-16 16:33 ` Ingo Schwarze @ 2023-08-16 18:25 ` Alejandro Colomar 2023-08-16 21:57 ` linting mdoc(7) pages (was: [PATCH v2] man*/: ffix (migrate to `MR`)) Alejandro Colomar 0 siblings, 1 reply; 17+ messages in thread From: Alejandro Colomar @ 2023-08-16 18:25 UTC (permalink / raw) To: Ingo Schwarze, G. Branden Robinson; +Cc: linux-man, groff [-- Attachment #1.1: Type: text/plain, Size: 3171 bytes --] Hi Ingo! On 2023-08-16 18:33, Ingo Schwarze wrote: > That perspective is not really helpful for general purpose Linux > distributions: for these, the Linux man-pages project matters a lot, > and that project is not considering the man(7) language as obsolete at > all. That i keep recommending changing that stance does not appear to > have much effect so far It does have an effect, or I like to think it has. Branden and I are pushing to improve man(7) to be on par with mdoc(7) where it's lacking. I also recently added support for mdoc(7) in the build system, so new mdoc(7) pages will enjoy the same linting level to which I subject our existing man(7) pages. If anyone wants to write new pages using mdoc(7), they're welcome. I'm not going to require man(7) (but I prefer it for my own pages). <https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/commit/share/mk?id=c76a587148d9b69667852311ece53403b1458844> <https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/commit/share/mk?id=5a34548ecbf4200b4a7bcc3ce9f26bedd84450cb> <https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/commit/share/mk?id=3c8198d1786501eb4a9e9a46c61c17ff233f3d54> So, if anyone wants to add a page that's not present, and decides to write it using mdoc(7), it'll be welcome. That includes the suggestion of a new intro.1, which IIRC was written in mdoc(7). I should revise that page. I lack experience using it, but I guess I'll learn more with enough time. Also, if anyone wants to fork this project and rewrite it using mdoc(7), or maybe use it for having a documentation repo of whatever project, I made it easy to do so. (In fact, I added mdoc(7) support for linting an mdoc(7) page at my job.) I even plan to add support for mm(7) pages, if POSIX deigns to talk to me to provide their sources. > and isn't relevant for the questions at hand. > Either war, a disagreement regarding the merits of some policy is > not a good reason to deprive users of information they might require. > >> I expect you will want to emphasize this in the release announcement, >> when the time comes. > > In the Linux man-pages project release announcement, i recommend > simply saying that groff_man(7) replaces the former man(7) that used > to be bundled in the Linux man-pages project. For the purposes of > the Linux man-pages project, the man(7) page distributed with mandoc > isn't useful, so no need to confuse the users of the Linux man-pages > project by talking about it. I'll probably have a few suggestions of how it could works, so that every distro understands what to do (even the small ones), but yeah, I'll keep it simple for the generic case, and suggest that most distros probably want to have a symlink from man(7) to groff_man(7). > [...] >> Unnerving, no? > > Heh, buhuuu! <evil grin> :-} Do you have in your plans to add support for MR? That's probably a blocker for applying Branden's patch in the master branch. Cheers, Alex > > Yours, > Ingo -- <http://www.alejandro-colomar.es/> GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5 [-- Attachment #2: OpenPGP digital signature --] [-- Type: application/pgp-signature, Size: 833 bytes --] ^ permalink raw reply [flat|nested] 17+ messages in thread
* linting mdoc(7) pages (was: [PATCH v2] man*/: ffix (migrate to `MR`)) 2023-08-16 18:25 ` Alejandro Colomar @ 2023-08-16 21:57 ` Alejandro Colomar 0 siblings, 0 replies; 17+ messages in thread From: Alejandro Colomar @ 2023-08-16 21:57 UTC (permalink / raw) To: Ingo Schwarze; +Cc: linux-man, groff [-- Attachment #1.1: Type: text/plain, Size: 2795 bytes --] Hi Ingo! On 2023-08-16 20:25, Alejandro Colomar wrote: > Hi Ingo! > > On 2023-08-16 18:33, Ingo Schwarze wrote: >> That perspective is not really helpful for general purpose Linux >> distributions: for these, the Linux man-pages project matters a lot, >> and that project is not considering the man(7) language as obsolete at >> all. That i keep recommending changing that stance does not appear to >> have much effect so far > > It does have an effect, or I like to think it has. Branden and I are > pushing to improve man(7) to be on par with mdoc(7) where it's lacking. > > I also recently added support for mdoc(7) in the build system, so new > mdoc(7) pages will enjoy the same linting level to which I subject our > existing man(7) pages. If anyone wants to write new pages using > mdoc(7), they're welcome. I'm not going to require man(7) (but I > prefer it for my own pages). > > <https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/commit/share/mk?id=c76a587148d9b69667852311ece53403b1458844> > <https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/commit/share/mk?id=5a34548ecbf4200b4a7bcc3ce9f26bedd84450cb> > <https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/commit/share/mk?id=3c8198d1786501eb4a9e9a46c61c17ff233f3d54> > > So, if anyone wants to add a page that's not present, and decides to > write it using mdoc(7), it'll be welcome. That includes the suggestion > of a new intro.1, which IIRC was written in mdoc(7). I should revise > that page. I lack experience using it, but I guess I'll learn more > with enough time. > > Also, if anyone wants to fork this project and rewrite it using mdoc(7), > or maybe use it for having a documentation repo of whatever project, > I made it easy to do so. (In fact, I added mdoc(7) support for linting > an mdoc(7) page at my job.) > > I even plan to add support for mm(7) pages, if POSIX deigns to talk to > me to provide their sources. BTW, I remember you showed interest in the ability to lint all pages. You may be interested in trying this: $ make lint-mdoc MANDIR=/home/alx/src/bsd/openbsd/src -k You may really use anything as MANDIR, and you may also use different targets, but lint-mdoc will run mandoc(1) as the linter, which I guess is the most interesting one to you. Check `make help` for that. You may need to adjust a few command variables to use the gnu variants, as I doubt I write portable stuff. Ye be warned. Check `make help-variables` for that. If you try this, you'll need the very latest commit, as I just fixed a bug in a script that misinterpreted some pathname in the OpenBSD tree. Cheers, Alex -- <http://www.alejandro-colomar.es/> GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5 [-- Attachment #2: OpenPGP digital signature --] [-- Type: application/pgp-signature, Size: 833 bytes --] ^ permalink raw reply [flat|nested] 17+ messages in thread
end of thread, other threads:[~2023-08-17 0:15 UTC | newest] Thread overview: 17+ messages (download: mbox.gz follow: Atom feed -- links below jump to the message on this page -- 2023-07-31 17:52 [PATCH v2] man*/: ffix (migrate to `MR`) G. Branden Robinson 2023-07-31 21:47 ` Alejandro Colomar 2023-07-31 22:50 ` G. Branden Robinson 2023-07-31 23:15 ` Alejandro Colomar 2023-08-01 20:10 ` G. Branden Robinson 2023-08-17 0:14 ` Brian Inglis 2023-07-31 22:16 ` Jakub Wilk 2023-07-31 23:30 ` Alejandro Colomar 2023-08-01 1:31 ` G. Branden Robinson 2023-08-01 13:35 ` Alejandro Colomar 2023-08-01 14:12 ` G. Branden Robinson 2023-08-12 15:35 ` Alejandro Colomar 2023-08-16 3:55 ` G. Branden Robinson 2023-08-16 12:12 ` Alejandro Colomar 2023-08-16 16:33 ` Ingo Schwarze 2023-08-16 18:25 ` Alejandro Colomar 2023-08-16 21:57 ` linting mdoc(7) pages (was: [PATCH v2] man*/: ffix (migrate to `MR`)) Alejandro Colomar
This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox; as well as URLs for NNTP newsgroup(s).