Thread (19 messages) 19 messages, 3 authors, 2024-03-18

Re: [PATCH v2 1/6] intro.1: Revise language

From: G. Branden Robinson <hidden>
Date: 2024-03-18 19:56:59

At 2024-03-19T08:50:21+1300, Jeremy Baxter wrote:
quoted
cat will show
but
cp copies
?
I think it sounds better to use the "x does this" form rather than the
"x will do this" form, similar to what they have in the utilities' own
man pages. What do you think? Should I change cat's description to
adhere to the rest or just keep all of them as they were?
Two rules I've been applying to my man page revisions for a while are:

* Favor active voice over passive.
* Favor present tense over future.

This is "favor", not "always use", but, other things being equal...

Regards,
Branden

Attachments

Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help