On 06/12/2023 09:03, Arsen Arsenović via GNU coreutils Bug Reports wrote:
Hi,
In the manpage of touch, 'touch' flag --time is described as:
--time=WORD
change the specified time: WORD is access, atime, or use:
equivalent to -a WORD is modify or mtime: equivalent to -m
... whereas, in the --help text, --time is described as:
--time=WORDchange the specified time:
WORD is access, atime, or use: equivalent to -a
WORD is modify or mtime: equivalent to -m
The latter is far more readable, and the manpage appears to be
mis-formatted (perhaps by help2man?).
IMO, the help text should also say 'if WORD is ..., or ...: ...' to
provide further clarity in the text.
The formatting issue is more pressing, however, as it makes the manpage
highly confusing compared to the help or manual texts.
Could this be corrected?
I pushed the following:
--time=WORDspecify which time to change:
access time (-a): 'access', 'atime', 'use';
modification time (-m): 'modify', 'mtime'
Marking this as done.
thanks,
Pádraig
