From patchwork Tue Jun 19 15:27:37 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: esr@thyrsus.com X-Patchwork-Id: 10474723 X-Patchwork-Delegate: herbert@gondor.apana.org.au Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id 2B35C60383 for ; Tue, 19 Jun 2018 15:35:11 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 1925928E02 for ; Tue, 19 Jun 2018 15:35:11 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 09A2328E1A; Tue, 19 Jun 2018 15:35:11 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-7.9 required=2.0 tests=BAYES_00, MAILING_LIST_MULTI, RCVD_IN_DNSWL_HI,T_TVD_MIME_EPI autolearn=ham version=3.3.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id B52B028E02 for ; Tue, 19 Jun 2018 15:35:09 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S966517AbeFSPfI (ORCPT ); Tue, 19 Jun 2018 11:35:08 -0400 Received: from thyrsus.com ([71.162.243.5]:41276 "EHLO snark.thyrsus.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S966078AbeFSPfH (ORCPT ); Tue, 19 Jun 2018 11:35:07 -0400 X-Greylist: delayed 450 seconds by postgrey-1.27 at vger.kernel.org; Tue, 19 Jun 2018 11:35:07 EDT Received: from [127.0.1.1] (localhost [127.0.0.1]) by snark.thyrsus.com (Postfix) with ESMTP id 7BBCA3A4F09 for ; Tue, 19 Jun 2018 11:27:37 -0400 (EDT) X-Mailbox-Line: From nobody Tue Jun 19 11:27:37 2018 MIME-Version: 1.0 To: dash@vger.kernel.org Subject: Problems in dash.1, sh.1, sh.distrib.1 Message-Id: <20180619152737.7BBCA3A4F09@snark.thyrsus.com> Date: Tue, 19 Jun 2018 11:27:37 -0400 (EDT) From: esr@thyrsus.com Sender: dash-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: dash@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP This is automatically generated email about markup problems in a man page for which you appear to be responsible. If you are not the right person or list, please tell me so I can correct my database. See http://catb.org/~esr/doclifter/bugs.html for details on how and why these patches were generated. Feel free to email me with any questions. Note: These patches do not change the modification date of any manual page. You may wish to do that by hand. I apologize if this message seems spammy or impersonal. The volume of markup bugs I am tracking is over five hundred - there is no real alternative to generating bugmail from a database and template. --- Eric S. Raymond Problems with dash.1: (Identical patches should apply to: sh.1 sh.distrib.1) Ambiguous or invalid backslash. This doesn't cause groff a problem. but it confuses doclifter and may confuse older troff implementations. --- dash.1-unpatched 2018-05-16 16:52:28.478288208 -0400 +++ dash.1 2018-05-16 16:52:28.182290220 -0400 @@ -1825,7 +1825,7 @@ .Ic shift will issue an error message, and exit with return status 2. .It test Ar expression -.It \&[ Ar expression Cm ] +.It \&[ Ar expression \&] The .Ic test utility evaluates the expression and, if it evaluates