Bug 23559

Summary:	app/xfs: Creation of doc/xfs-design.pdf fails
Product:	xorg	Reporter:	Gaetan Nadon <memsize>
Component:	App/xfs	Assignee:	Xorg Project Team <xorg-team>
Status:	CLOSED NOTABUG	QA Contact:	Xorg Project Team <xorg-team>
Severity:	minor
Priority:	low	CC:	alan.coopersmith
Version:	git	Keywords:	janitor
Hardware:	x86-64 (AMD64)
OS:	Linux (All)
Whiteboard:
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
(./tmp.fo
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):
(/usr/share/texmf/tex/xmltex/config/xmltex.cfg) 
No File: tmp.cfg (/usr/share/texmf/tex/xmltex/passivetex/fotex.xmt)
(/usr/share/texmf-texlive/tex/latex/base/article.cls
Document Class: article 2005/09/16 v1.4f Standard LaTeX document class
(/usr/share/texmf-texlive/tex/latex/base/size10.clo))
(/usr/share/texmf/tex/xmltex/passivetex/fotex.sty
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.