Bug 23559 - app/xfs: Creation of doc/xfs-design.pdf fails
Summary: app/xfs: Creation of doc/xfs-design.pdf fails
Alias: None
Product: xorg
Classification: Unclassified
Component: App/xfs (show other bugs)
Version: git
Hardware: x86-64 (AMD64) Linux (All)
: low minor
Assignee: Xorg Project Team
QA Contact: Xorg Project Team
Keywords: janitor
Depends on:
Reported: 2009-08-27 11:11 UTC by Gaetan Nadon
Modified: 2011-10-15 16:43 UTC (History)
1 user (show)

See Also:
i915 platform:
i915 features:


Description Gaetan Nadon 2009-08-27 11:11:48 UTC
The following rule fails to create the .pdf file (from git master).

doc/xfs-design.pdf: $(srcdir)/doc/xfs-design.xml $(srcdir)/doc/xfs-design.xsl
	$(XMLTO) -m $(srcdir)/doc/xfs-design.xsl -o doc pdf $(srcdir)/doc/xfs-design.xml

On my workstation (Ubuntu Jaunty) the xmlto 0.0.20 is installed but does not contain the PassiveTex package which is required for the pdf conversion (The conversion to html works). After much digging, I found that the xmltex package would do the job. No complaints about PassiveTex, however it fails for some unclear reasons.

Output of 'make doc/xfs-design.pdf when using xmltex:
/usr/bin/xmlto -m ./doc/xfs-design.xsl -o doc pdf ./doc/xfs-design.xml
Making portrait pages on a4 paper (210mmx297mm)
This is pdfTeXk, Version 3.141592-1.40.3 (Web2C 7.5.6)
 %&-line parsing enabled.
entering extended mode
LaTeX2e <2005/12/01>
Babel <v3.8h> and hyphenation patterns for english, usenglishmax, dumylang, noh
yphenation, loaded.
xmltex version: 2002/06/25 v1.9 (Exp):
No File: tmp.cfg (/usr/share/texmf/tex/xmltex/passivetex/fotex.xmt)
Document Class: article 2005/09/16 v1.4f Standard LaTeX document class
make[1]: *** [doc/xfs-design.pdf] Error 1
make[1]: Leaving directory `/home/nadon/xorg/src/app/xfs'
make: *** [all] Error 2

Looking around, I realized that:
- there is no other module in X.Org that uses xmlto for a pdf conversion
- I installed xfs (from distro) and noticed the pdf doc isn't there. Most likely the distro builder couldn't get it to build either.
- there are very few pdf docs in /usr/share/doc
- there is a --enable-devel-docs xfs configure option which turns off all docs

I am wondering if it works on non-Linux platforms. I removed the rule to bypass the pdf, and the next target xfs-design.txt was created but it is unreadable having no formatting whatsoever.
Comment 1 Gaetan Nadon 2009-09-25 15:28:38 UTC
Looking at tinderbox build logs, the pdf document gets created. It must be that I can't find the right package for the PassiveTex extension.

Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.