Re: [9front] Re: man pages

[hiro <23hiro@gmail.com>]

ori is probably right, but calling it all bikeshedding is also not
fair IMO. hopefully i missed the irony :)

there have been some changes that regard stylistic choices, where
neither option is more correct than the other,

to add further bikeshedding, some few changes are inconsistent.
e.g. SuperSpeed should be superspeed or super-speed IMO to fit into
the rest of the sentence.

On 8/25/21, ori@eigenstate.org <ori@eigenstate.org> wrote:
> Quoth Humm <hummsmith42@gmail.com>:
>> > I'm sure there are all of sorts of inconsistencies all over the
>> > place, but expecting anyone to review and fix everything at once is
>> > too much, it won't happen.
>>
>> Oh yes, there are.  What comes to mind immediately is citation style
>> and handling of options in SYNOPSIS (sometimes all are listed and
>> sometimes there is just “[options]”), as well as just bad troff.
>> There are some checks for bad stuff (see for example `mk punccheck` in
>> /sys/man).
>
> yes, for sure.
>
> it helps me out if I get patches that focus on
> one kind of issue: I have to keep less in mind
> when reviewing, and format fixes are going to
> get less debate than phrasing changes; I like it
> when I can land fixes immediately.
>
>