bug-coreutils
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

bug#67656: 'man touch' text about --time hard to read compared to 'touch


From: Arsen Arsenović
Subject: bug#67656: 'man touch' text about --time hard to read compared to 'touch --help'
Date: Wed, 06 Dec 2023 10:03:52 +0100

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=WORD        change 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?

Thanks, have a lovely day!
-- 
Arsen Arsenović

Attachment: signature.asc
Description: PGP signature


reply via email to

[Prev in Thread] Current Thread [Next in Thread]