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=1.2 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,FREEMAIL_FROM,RDNS_NONE autolearn=no autolearn_force=no version=3.4.4 Received: (qmail 30619 invoked from network); 25 Aug 2021 09:46:35 -0000 Received: from unknown (HELO 4ess.inri.net) (216.126.196.42) by inbox.vuxu.org with ESMTPUTF8; 25 Aug 2021 09:46:35 -0000 Received: from mail-pg1-f171.google.com ([209.85.215.171]) by 4ess; Wed Aug 25 05:37:31 -0400 2021 Received: by mail-pg1-f171.google.com with SMTP id r2so22499991pgl.10 for <9front@9front.org>; Wed, 25 Aug 2021 02:37:25 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :content-transfer-encoding; bh=UKgVmPAa0YGK8gRVGOi8OvXyvfnX5QR+JhJOd4U0Ycg=; b=V/p8GH2yUT4YRZCVVkinXSZFIKrPIaWC9vchImSZDf2ZvaaLwxybPbcr06WPtnhU8t 8gfuc9VetkdZRKZnChl7bXM/A9mzgDRA0b/pkxiPR4/OBD+6VhSRZQK/HbivAl6o9JGI jnJEMPifCjVH6g5eZrGCGbFb4MIKRU+RkFGSmW8paMfla+jHpG5ipvZVTebttU9ZQrWA ARmcBVIAs6XHu9AeeRv/kbhJzB807wv90HLvlNFjTyGrLrlCVAmnltj4g4TFhPngY7NW 43GOGkeK4m91kKSs4ore4PQi/Jc0eg02TXbtekdUuwVQjliuDmVuqrlUVQXsx6x3kt1U 6hXQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:in-reply-to:references:from:date :message-id:subject:to:content-transfer-encoding; bh=UKgVmPAa0YGK8gRVGOi8OvXyvfnX5QR+JhJOd4U0Ycg=; b=m7n+iV7khEG9Y6EWhVDZSU22O865NFSGZ0q+Pe+b9LrfwOc0FR12o5NeSCNihwsJMe G+BFy+YX23UdDLMsmQnIDjwMlL9MOYW+4Yp2pT7XqRDh0T5D7WF3m9oc8jTdnciZRYkk xekelKI9G3ry/OWnLf6mCINia49QObJuYJv4zaCmfzB+GTdsBsU5kaUOjGWnaQ/YIL78 zJwCNZxYMEz4yOXCPamiscdvxOojC2jX3SvwWlqCZAhSaTBR3PzBcjr6Ok4T6CbFJP/M N3mOiOXw3uzi8qbXuguMIWSa03uX3GDXxPrgF0XvKml8LYRVqbY87EVlqWChHb9Heplg i4qQ== X-Gm-Message-State: AOAM530ZN/5nv4yVvclnH3c7339j9tfsc72bDKqlBEW+fzauRMO9NdKI dejiBisk8BN52bWz3zk1uLjt5Uv2FgJR3nfJcycatEEQdk4= X-Google-Smtp-Source: ABdhPJynUXpIcOu6AuVLZRfLl1LCORtJ+0k0PVnkTPRO0JxevzKY2D4m4bQufNm4QYZdizFLCExBNBtFUvNkJs+H0+U= X-Received: by 2002:a62:7915:0:b0:3ed:972c:1544 with SMTP id u21-20020a627915000000b003ed972c1544mr8146403pfc.18.1629884243593; Wed, 25 Aug 2021 02:37:23 -0700 (PDT) MIME-Version: 1.0 Received: by 2002:a05:6a20:3210:b029:36:6c8c:f6d1 with HTTP; Wed, 25 Aug 2021 02:37:22 -0700 (PDT) In-Reply-To: References: From: hiro <23hiro@gmail.com> Date: Wed, 25 Aug 2021 11:37:22 +0200 Message-ID: To: 9front@9front.org Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable List-ID: <9front.9front.org> List-Help: X-Glyph: ➈ X-Bullshit: secure standard GPU-oriented realtime control Subject: Re: [9front] Re: man pages Reply-To: 9front@9front.org Precedence: bulk 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 wrote: > 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 =E2=80=9C[options]=E2=80=9D), as well as just ba= d 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. > >