On Tue Mar 19, 2024 at 11:05 AM NZDT, Alejandro Colomar wrote: > Hi Jeremy, Branden, > > On Mon, Mar 18, 2024 at 02:56:57PM -0500, G. Branden Robinson wrote: > > 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... > > For intro(1), we could make an exception. A less formal voice might > seem more friendly to newcomers. Don't you think? > > BTW Jeremy, you could send less changes. I'm not very happy about such > huge changes suddenly. How about fixing what you feel is most obvious > that should be fixed, say 20 lines or so, and in a month or so we can > discuss another patch set for this page? No worries, splitting the patch over time sounds good. Sorry for the inconvenience. ~Jeremy > > Have a lovely day! > Alex > > > > > Regards, > > Branden
