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

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

 



At 2024-03-19T08:50:21+1300, Jeremy Baxter wrote:
> > 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

Attachment: signature.asc
Description: PGP signature


[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux