From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mailout.scc.kit.edu (mailout.scc.kit.edu [129.13.185.202]) by krisdoz.my.domain (8.14.5/8.14.5) with ESMTP id s5ECRdnF020567 for ; Sat, 14 Jun 2014 08:27:39 -0400 (EDT) Received: from hekate.usta.de (asta-nat.asta.uni-karlsruhe.de [172.22.63.82]) by scc-mailout-02.scc.kit.edu with esmtp (Exim 4.72 #1) id 1Wvn3b-0000wO-75; Sat, 14 Jun 2014 14:27:39 +0200 Received: from donnerwolke.usta.de ([172.24.96.3]) by hekate.usta.de with esmtp (Exim 4.77) (envelope-from ) id 1Wvn3S-0002cm-UM; Sat, 14 Jun 2014 14:27:30 +0200 Received: from iris.usta.de ([172.24.96.5] helo=usta.de) by donnerwolke.usta.de with esmtp (Exim 4.72) (envelope-from ) id 1Wvn8n-00079g-BH; Sat, 14 Jun 2014 14:33:01 +0200 Received: from schwarze by usta.de with local (Exim 4.77) (envelope-from ) id 1Wvn3b-0004wW-2T; Sat, 14 Jun 2014 14:27:39 +0200 Date: Sat, 14 Jun 2014 14:27:39 +0200 From: Ingo Schwarze To: discuss@mdocml.bsd.lv, David Holland Subject: Re: Extension for more general documents Message-ID: <20140614122739.GB27521@iris.usta.de> References: <20140613083536.GJ14438@danbala.tuwien.ac.at> <539ABA77.4050305@bsd.lv> <20140613100550.GB27739@iris.usta.de> <20140613110603.GB18807@danbala.tuwien.ac.at> <20140613114459.GN14438@danbala.tuwien.ac.at> <20140613140402.GA4354@crux> X-Mailinglist: mdocml-discuss Reply-To: discuss@mdocml.bsd.lv MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20140613140402.GA4354@crux> User-Agent: Mutt/1.5.21 (2010-09-15) Hi, Svyatoslav Mishyn wrote on Fri, Jun 13, 2014 at 05:04:03PM +0300: > just notice > maybe AsciiDoc will be interesting.. No, it will not. Never use AsciiDoc or DocBook for anything related to manuals. The man(7) code generated from the AsciiDoc/DocBook toolchain is by far the worst quality autogenerated man(7) code you can find from any autogeneration tool chain i'm aware of. It is the worst by such a large margin that DocBook alone is responsible for the overwhelming majority of bogus bug reports for mandoc, that is reports that something is presumably broken in mandoc which turn out to be merely broken mandoc *input* generated from some buggy autogenerator. Besides, the AsciiDoc toolchain is incredibly slow. Generating man(7) code from AsciiDoc typically takes about hundred (!) times the CPU time required to format that man(7) code for terminal output with mandoc(1). If you must autogenerate man(7) code for some reason, even the Perl "plain old documentation" (POD) format is a much better starting point than AsciiDoc. But i wouldn't recomment that, or generating man(7) code at all, either. Just use mdoc(7), Thomas is right in that respect. Yours, Ingo -- To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv