[Pkg-haskell-maintainers] Bug#646100: Do not create DocBook-XML suitable for xmlto

[Juhapekka Tolvanen]

On Tue, 01 Nov 2011, +07:52:47 EET (UTC +0200),
John MacFarlane <jgm at berkeley.edu> pressed some keys:

> +++ Juhapekka Tolvanen [Oct 21 11 12:47 ]:
> > Package: pandoc
> > Version: 1.8.2.1-2+b2
> > Severity: important
> > 
> > 
> > That XML-file is available here:
> > 
> > http://iki.fi/juhtolv/tolleharj/
> > 
> > juhtolv at juhtolv:/home/juhtolv/seka/Eckhart_Tolle/harjoitukset % tidy -m -xml -utf8 juhtolv_tolle_harjoitukset.xml
> > No warnings or errors were found.
> > 
> > 
> > To learn more about HTML Tidy see http://tidy.sourceforge.net
> > Please fill bug reports and queries using the "tracker" on the Tidy
> > web site.
> > Additionally, questions can be sent to html-tidy at w3.org
> > HTML and CSS specifications are available from http://www.w3.org/
> > Lobby your company to join W3C, see http://www.w3.org/Consortium
> > 
> > juhtolv at juhtolv:/home/juhtolv/seka/Eckhart_Tolle/harjoitukset % xmlto -vv man juhtolv_tolle_harjoitukset.xml     
> > Source format: docbook / root element: nodes: 
> > Format script: /usr/share/xmlto/format/docbook/man
> > Convert to troff
> > Real stylesheet:
> > http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl
> > /usr/bin/xmllint --noout --nonet --xinclude --postvalid --noent
> > "/home/juhtolv/seka/Eckhart_Tolle/harjoitukset/juhtolv_tolle_harjoitukset.xml"
> > Stylesheet: /tmp/xmlto-xsl.CcGAAv
> > /usr/bin/xsltproc   --nonet --xinclude \
> >  -o "/tmp/xmlto.rBtMnG/juhtolv_tolle_harjoitukset.proc" \
> >  /tmp/xmlto-xsl.CcGAAv \
> >  "/home/juhtolv/seka/Eckhart_Tolle/harjoitukset/juhtolv_tolle_harjoitukset.xml"
> > Erro:  no refentry: No refentry elements found in "Läsnäolon voim
> > Läsnäolon voima -kirjan harjoitukset: Eräänlaiset muistiinpanot
> > [1]    1647 exit 1     xmlto -vv man juhtolv_tolle_harjoitukset.xml
> 
> I don't consider this a bug.
> 
> 'xmlto html' and 'xmlto pdf' work fine for this input. 'xmlto man' apparently
> expects a certain kind of docbook file -- one whose main node is 'refentry'.
> http://docbook.org/tdg/en/html/refentry.html
> 
> Pandoc could only know to produce such a file if it knew ahead of time what
> you planned to do with the docbook file you were generating, and of course it
> can't know that.

Is it possible to use reStructuredText and pandoc so that also that
refentry is created?

Anyway, I just found out python-docutils has rst2man and it works.


-- 
Juhapekka "naula" Tolvanen * http colon slash slash iki dot fi slash juhtolv
"Quidquid Latine dictum sit altum videtur."