From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail.sgregoratto.me (mail.sgregoratto.me [149.28.166.45]) by fantadrom.bsd.lv (OpenSMTPD) with ESMTP id 184eee17 for ; Sat, 23 Mar 2019 05:18:40 -0500 (EST) Received: from mail.sgregoratto.me (localhost [127.0.0.1]) by mail.sgregoratto.me (Postfix) with ESMTP id 7F0053E8D8 for ; Sat, 23 Mar 2019 21:18:37 +1100 (AEDT) Authentication-Results: mail.sgregoratto.me (amavisd-new); dkim=pass (1024-bit key) reason="pass (just generated, assumed good)" header.d=sgregoratto.me DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=sgregoratto.me; h=user-agent:in-reply-to:content-disposition:content-type :content-type:mime-version:references:message-id:subject:subject :to:from:from:date:date; s=dkim; t=1553336316; x=1555928317; bh= yS6bWYldmeQOZ/w0+kzsg58PkZbMCYeStQHtGP6Jybg=; b=Bt6dGAaH281hOtqc ym0P0VzPn7R6KwvMbkI/uPO1Hinub9NprMTrJWf4cd1aSb7XRArrOqISRVfkGj2R 4dGj9aZkYT3XraIm+sqUmRTMiu/8ratMwj7I56S47zNHuh6zxvtMpmZxiD+AVtTP 07cfGqUceW31CdTCS+AX0xer+HU= X-Virus-Scanned: Debian amavisd-new at mail.sgregoratto.me Received: from mail.sgregoratto.me ([127.0.0.1]) by mail.sgregoratto.me (mail.sgregoratto.me [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id FbZHQHOFsgBs for ; Sat, 23 Mar 2019 21:18:36 +1100 (AEDT) Received: from localhost (172.44.179.58.sta.dodo.net.au [58.179.44.172]) by mail.sgregoratto.me (Postfix) with ESMTPSA id 89A093E8C3 for ; Sat, 23 Mar 2019 21:18:36 +1100 (AEDT) Date: Sat, 23 Mar 2019 21:18:35 +1100 From: Stephen Gregoratto To: tech@mandoc.bsd.lv Subject: Re: [PATCH docbook2mdoc] Add NODE_EMAIL Message-ID: <20190323101835.bqaltgzmfbnvxcfl@BlackBox> References: <20190322103342.6idzehqruirutcog@BlackBox> <20190322200700.GD6535@athene.usta.de> <20190323053008.vctluoysjwtc3usv@BlackBox> <20190323084616.GA62193@athene.usta.de> X-Mailinglist: mandoc-tech Reply-To: tech@mandoc.bsd.lv MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline In-Reply-To: <20190323084616.GA62193@athene.usta.de> User-Agent: NeoMutt/20180716 On 2019-03-23 09:46, Ingo Schwarze wrote: > I can't say i have ever *used* the DocBook format, but the man(7) > output from DocBook files has struck me over and over again as the > by far lowest quality man(7) code i have ever seen from any manual > page generator. DocBook is without any doubt the number one manual > page generation scheme causing the most trouble in real life, in > multiple respects. By far. So i am definitely not able to approach > DocBook in good faith; i strongly hate DocBook and i am heavily > biased against it based on previous experience. But our different > perspective on it can likely be productive. :) I believe you've mentioned this before on the markdown output article on undeadly.org. Actually that section at the end was the reason why I'm making these comparisons. I forgot to mention that I'll be publishing my findings on my blog. I aim to write up an example user command/library call man-page, porting them by hand to the different formats. I'll describe the methods/programs used to validate/format/convert each format, and analyse the quality of the conversions. I'll also see how it fares going through mandoc's HTML output, groff's PDF output and the UTF-8 output of both. Finally, I'll ask each respective "camp" if they'd like to comment on my findings, and include them at the end (that means you, Ingo). That's why I say good faith, I certainly don't want to anger anyone from a different camp by hating their work right out of the gate. That I can leave that up to you ;). > I'm not sure i understand that sentence. What do you mean with > "I'll put"? Aren't DocBook elements part of input documents, and > aren't input documents things that are given a priori? How can you > influence what is found in input documents? Whoops, forgot to put in the rest of the nodes. What I meant to say was that I'll do this: Authors The foo utility is maintained by ... . -- Stephen Gregoratto PGP: 3FC6 3D0E 2801 C348 1C44 2D34 A80C 0F8E 8BAB EC8B -- To unsubscribe send an email to tech+unsubscribe@mandoc.bsd.lv