Re: CVS commit: src/usr.bin/man

[Valery Ushakov <uwe%stderr.spb.ru@localhost>]

On Sat, Jun 18, 2022 at 02:19:07 +0000, David H. Gutteridge wrote:

> Module Name:	src
> Committed By:	gutteridge
> Date:		Sat Jun 18 02:19:07 UTC 2022
> 
> Modified Files:
> 	src/usr.bin/man: man.conf.5
> 
> Log Message:
> man.conf.5: add details about the machine line and search order
> 
> Also, tweak some grammar, style, and markup while here.
> 
> 
> To generate a diff of this commit:
> cvs rdiff -u -r1.27 -r1.28 src/usr.bin/man/man.conf.5

Please, could you rephrase the bit about the _<machine> keyword.  It
is not quite clear on the first reading which is the keyword and which
is the value (epecially in text output where formatting (wrong anyway
:) doesn't provide a hint).  Using "value" to talk about the keyword
doesn't help too.  Also, "commonly" in the added phrase is misleading
I'd say.  Commonly implies "not always", which is false - we suppply
x86 as an extra subdir in the default man.conf.  I know that passage
was not very clear to begin with, but you touch it you buy it :).

Not being a native speaker I don't dare touching it, I'm afraid to
make more mess.

TIA!

-uwe