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=T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 14776 invoked from network); 20 Mar 2022 16:00:36 -0000 Received: from bsd.lv (HELO mandoc.bsd.lv) (66.111.2.12) by inbox.vuxu.org with ESMTPUTF8; 20 Mar 2022 16:00:36 -0000 Received: from fantadrom.bsd.lv (localhost [127.0.0.1]) by mandoc.bsd.lv (OpenSMTPD) with ESMTP id 28de6d8a for ; Sun, 20 Mar 2022 11:00:34 -0500 (EST) Received: from scc-mailout-kit-02.scc.kit.edu (scc-mailout-kit-02.scc.kit.edu [129.13.231.82]) by mandoc.bsd.lv (OpenSMTPD) with ESMTP id f8da6602 for ; Sun, 20 Mar 2022 11:00:33 -0500 (EST) Received: from hekate.asta.kit.edu ([2a00:1398:5:f401::77]) by scc-mailout-kit-02.scc.kit.edu with esmtps (TLS1.3:ECDHE_SECP256R1__RSA_PSS_RSAE_SHA256__AES_256_GCM:256) (envelope-from ) id 1nVxyq-00BVkc-Bu; Sun, 20 Mar 2022 17:00:32 +0100 Received: from login-1.asta.kit.edu ([2a00:1398:5:f400::72]) by hekate.asta.kit.edu with esmtp (Exim 4.94.2) (envelope-from ) id 1nVxyo-003mRn-V0; Sun, 20 Mar 2022 17:00:31 +0100 Received: from schwarze by login-1.asta.kit.edu with local (Exim 4.92) (envelope-from ) id 1nVxyp-00069j-B8; Sun, 20 Mar 2022 17:00:31 +0100 Date: Sun, 20 Mar 2022 17:00:31 +0100 From: Ingo Schwarze To: paul@apatience.com, discuss@mandoc.bsd.lv Subject: Re: Spurious space in demandoc.1 Message-ID: References: <87o82aabvi.fsf@apatience.com> X-Mailinglist: mandoc-discuss Reply-To: discuss@mandoc.bsd.lv MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <87o82aabvi.fsf@apatience.com> Hi Paul, Paul A. Patience wrote on Sun, Mar 13, 2022 at 01:20:37AM +0000: > I found a typo in demandoc.1. > Not sure if it's worth a commit all by itself. Yes it would, even small bugs are worth fixing, and there is no benefit to letting bugfix patches accumulate before committing. However, the whole sentence is misplaced, meaningless, and confusing in this manual page, so i just deleted the whole line outright, see the committed patch below. While here, please note that the whole demandoc(1) program is kind of an anachronism. You are usually better off using "mandoc FILE | col -b" instead because demandoc(1) soemtimes deletes too much from the output stream. Multiple times, i felt tempted to delete the whole demandoc(1) program from the mandoc toolbox without any replacement. The only reason i didn't delete it yet is that i'm not completely sure what people use it for, how they use it, and why. Myself, i certainly do not use it and hardly bother maintaining it unless compilation breaks. Then again, i absolutely never use spell checking programs, and when they are built in to other software, i completely disable all spell checking features wherever i can. *If* demandoc(1) has any merit in the context of spell checking (or in any other area) then rather than deleting it outright, it would be better to clean up and improve the required features and include them in the mandoc(1) program itself. So demandoc(1) will probably lurk around half-unmaintained until i understand its uses and find a tester who will explain those uses and later test patches to mandoc to support them natively instead of in a rather dirty additional program. Yours, Ingo Index: demandoc.1 =================================================================== RCS file: /home/cvs/mandoc/mandoc/demandoc.1,v retrieving revision 1.8 diff -u -r1.8 demandoc.1 --- demandoc.1 12 Sep 2014 00:10:26 -0000 1.8 +++ demandoc.1 20 Mar 2022 15:36:09 -0000 @@ -80,7 +80,6 @@ Such errors cause .Nm to exit at once, possibly in the middle of parsing or formatting a file. -The output databases are corrupt and should be removed . .El .Sh EXAMPLES The traditional usage of -- To unsubscribe send an email to discuss+unsubscribe@mandoc.bsd.lv