]> git.ipfire.org Git - thirdparty/coreutils.git/commit
doc: man: consistently italicize --option parameters
authorPádraig Brady <P@draigBrady.com>
Wed, 1 Oct 2025 17:38:21 +0000 (18:38 +0100)
committerPádraig Brady <P@draigBrady.com>
Thu, 2 Oct 2025 09:13:53 +0000 (10:13 +0100)
commit1cac40b6373fe414b2f75f2c93abccf990d2834b
tree53d9804495b39b449dd638225b042041141cf751
parent7d55fd0aa3f171163a7bd6e7fc774e6acdafc52a
doc: man: consistently italicize --option parameters

This changes a few pages, but the changes in tail.1
concisely illustrate the resulting man page changes:

  $ diff -r man.orig/tail.1 man/tail.1
  < \fB\-c\fR, \fB\-\-bytes\fR=\fI\,[\/\fR+]NUM
  > \fB\-c\fR, \fB\-\-bytes\fR=\fI\,[+]NUM\/\fR

  < \fB\-f\fR, \fB\-\-follow[=\fR{name|descriptor}]
  > \fB\-f\fR, \fB\-\-follow\fR[=\fI\,{name|descriptor}\/\fR]

  < \fB\-n\fR, \fB\-\-lines\fR=\fI\,[\/\fR+]NUM
  > \fB\-n\fR, \fB\-\-lines\fR=\fI\,[+]NUM\/\fR

* man/help2man: Relax the option match so more --option
variations are supported, and passed through to convert_option().
Specifically more variations after '=' are now supported.
Also split and document the regular expression.
Reported at https://github.com/coreutils/coreutils/issues/84
man/help2man