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 bac9ca09 for ; Sat, 23 Mar 2019 00:30:12 -0500 (EST) Received: from mail.sgregoratto.me (localhost [127.0.0.1]) by mail.sgregoratto.me (Postfix) with ESMTP id 5D0423E8D8 for ; Sat, 23 Mar 2019 16:30:09 +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=1553319008; x=1555911009; bh= vv6HSnWb5xCZtb2bys4H6ks4NCiFM8iqHYO70Kb2jzI=; b=Hwu/AeLwY/yMhjP5 6mKphRKapwr9kNbQhhulpur/Hf46FDTmTAf9NKfK8cXw4BtYt4OW7/6Iy3wZTZED Umto4NW+m23OwF7K5FF7pESXf3/VL0IgZOxeCi8Qa2i/+A+HFxfauExPYrqO5TRL Xb23UhBXYJZK0H5MvXr1v8EiiMQ= 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 W2em7j6J2w_4 for ; Sat, 23 Mar 2019 16:30:08 +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 630A53E868 for ; Sat, 23 Mar 2019 16:30:08 +1100 (AEDT) Date: Sat, 23 Mar 2019 16:30:08 +1100 From: Stephen Gregoratto To: tech@mandoc.bsd.lv Subject: Re: [PATCH docbook2mdoc] Add NODE_EMAIL Message-ID: <20190323053008.vctluoysjwtc3usv@BlackBox> References: <20190322103342.6idzehqruirutcog@BlackBox> <20190322200700.GD6535@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: <20190322200700.GD6535@athene.usta.de> User-Agent: NeoMutt/20180716 On 2019-03-22 21:07, Ingo Schwarze wrote: > In the future, it might be useful to mention in which real-world > document(s) you found a given feature used. The manpages for doclifter/manlifter[1] contain esr's email address enclosed in an node. I've also come across the block in the GNOME project's GTK docs[2]. The big DocBook users are the FreeDesktop group and it's members: GNOME, KDE, Systemd et al. If we work through the smaller cases (like GTK's), we can eventually start thinking about how to transform longer and more complicated ones. Case in point, this section I found in the GTK docs[3]. > Thank you, help working on docbook2mdoc(1) is certainly welcome! > Just out of curiosity: What are you using docbook2mdoc(1) for? I've interacted with many manpage generators so far, so I thought I'd make a good faith comparison between the many I've seen/used in OSS. I've decided I'd start with the generators I know the least, which are refentry files. I was going to compare docbook2mdoc's output to the official XSL stylesheets to see how they compare, But I can't compare them if it exits on an unseen node ;). Also, I do like using mdoc and mandoc and thought I could help out with the DocBook converter. My personal goal is to convert most of the systemd manpages, as they contain many tables/code listings that would look good when going through mandoc's HTML output. > I rebased your patch such that it applied to HEAD and committed it > in the following form. > > Test results: > $ cat tmp.txt > > > Joe > Bloggo > Bloggs > > joe@foo.net > > $ ./docbook2mdoc tmp.txt | man -lc > UNKNOWN(1) General Commands Manual UNKNOWN(1) > > Joe Bloggo Bloggs > > OpenBSD 6.4 March 22, 2019 OpenBSD 6.4 Cheers. Something I noticed is that many documents put the authors in the section, which the XSL stylesheets move into AUTHORS. Not sure how we would deal with this. Perhaps a string buffer or array of struct author that could be printed out at the end/before CAVEATS/BUGS et al.? For now I'll put my node in its own . [1] https://gitlab.com/esr/doclifter/raw/master/doclifter.xml [2] https://gitlab.gnome.org/GNOME/gtk/raw/master/docs/reference/gtk/gtk4-launch.xml [3] https://gitlab.gnome.org/GNOME/gtk/blob/master/docs/reference/gtk/css-overview.xml#L510 -- Stephen Gregoratto PGP: 3FC6 3D0E 2801 C348 1C44 2D34 A80C 0F8E 8BAB EC8B -- To unsubscribe send an email to tech+unsubscribe@mandoc.bsd.lv