From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=0.0 required=5.0 tests=none autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 24251 invoked from network); 25 Aug 2021 08:51:53 -0000 Received: from 1ess.inri.net (HELO 4ess.inri.net) (216.126.196.35) by inbox.vuxu.org with ESMTPUTF8; 25 Aug 2021 08:51:53 -0000 Received: from mimir.eigenstate.org ([206.124.132.107]) by 4ess; Wed Aug 25 04:46:09 -0400 2021 Received: from abbatoir.myfiosgateway.com (pool-74-108-56-225.nycmny.fios.verizon.net [74.108.56.225]) by mimir.eigenstate.org (OpenSMTPD) with ESMTPSA id 92334e7a (TLSv1.2:ECDHE-RSA-AES256-SHA:256:NO) for <9front@9front.org>; Tue, 24 Aug 2021 20:18:51 -0700 (PDT) Message-ID: To: 9front@9front.org Date: Tue, 24 Aug 2021 23:18:49 -0400 From: ori@eigenstate.org In-Reply-To: MIME-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: 8bit List-ID: <9front.9front.org> List-Help: X-Glyph: ➈ X-Bullshit: immutable responsive service high-performance cloud Subject: Re: [9front] Re: man pages Reply-To: 9front@9front.org Precedence: bulk Quoth Humm : > > 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.