Skip to contentSkip to conversation

DocBook build failures, and graphical figures

DISCUSSION Jeff Garzik 2 participants 4 messages May 31, 2005 – Jun 2, 2005

lore
Share & tools
lore
#0 lore raw

Some DocBook-related comments and questions:

* "make psdocs" and "make pdfdocs" both fail in current tree, on Fedora Core 2 (FC2) and Red Hat Enterprise Linux 4 (RHEL4). Strangely enough, they fail on different files. I've attached output-psdocs.txt and output-pdfdocs.txt showing the errors I get.

Both psdocs and pdfdocs -do- work for some files. Each target proceeds for a bit, and then finds a specific file it doesn't like, and dies. 100% reproducible.

In each failing case, I can use "db2ps" or "db2pdf" to successfully convert the XML file, whereas xmlto fails.

* Can you make it easy to change the paper size to something custom, like 6x9in ?

* Is there an example somewhere describing how to insert graphics (figures and charts) ?

Regards and thanks,

Jeff

#1 lore raw
Quoted 4 lines · Jeff Garzik

Some DocBook-related comments and questions:

* "make psdocs" and "make pdfdocs" both fail in current tree, on Fedora Core 2 (FC2) and Red Hat Enterprise Linux 4 (RHEL4). Strangely enough, they fail on different files. I've attached output-psdocs.txt and output-pdfdocs.txt showing the errors I get.

Sigh. Forgot the attachments.

Also, an additional detail: "make mandocs" and "make htmldocs" work fine, for all files.

Jeff

XMLTO Documentation/DocBook/kernel-locking.pdf
Making portrait pages on USletter paper (8.5inx11in)
This is pdfTeX, Version 3.14159-1.10b (Web2C 7.4.5) (./tmp.fo{/usr/share/texmf/pdftex/config/pdftex.cfg}
LaTeX2e <2001/06/01>
Babel <v3.7h> and hyphenation patterns for american, french, german, ngerman, n ohyphenation, loaded.
xmltex version: 2002/06/25 v1.9 (Exp):
(/usr/share/texmf/tex/xmltex/xmltex.cfg)
No File: tmp.cfg (/usr/share/texmf/tex/xmltex/passivetex/fotex.xmt) (/usr/share/texmf/tex/latex/base/article.cls
Document Class: article 2001/04/21 v1.4e Standard LaTeX document class (/usr/share/texmf/tex/latex/base/size10.clo)) (/usr/share/texmf/tex/xmltex/passivetex/fotex.sty
)
No file tmp.aux.
(/usr/share/texmf/tex/latex/cyrillic/t2acmr.fd) (/usr/share/texmf/tex/latex/base/ts1cmr.fd) (/usr/share/texmf/tex/latex/psnfss/t1ptm.fd)
No file tmp.out.
No file tmp.out.
INFO: Using normal, i.e. nonfrench-spacing in document (/usr/share/texmf/tex/latex/psnfss/t1phv.fd) (/usr/share/texmf/tex/latex/psnfss/t1pcr.fd) [1{/usr/share/texmf/dvips/config/p dftex.map}] (/usr/share/texmf/tex/latex/psnfss/ts1ptm.fd) [2] (/usr/share/texmf/tex/latex/amsfonts/umsa.fd) (/usr/share/texmf/tex/latex/amsfonts/umsb.fd) (/usr/share/texmf/tex/latex/wasysym/uwasy.fd) (/usr/share/texmf/tex/latex/misc/ustmry.fd) [3] [4]

LaTeX Font Warning: Font shape `OT1/cmr/m/n' in size <12.44159> not available
(Font) size <12> substituted on input line 465.

LaTeX Font Warning: Font shape `OML/cmm/m/it' in size <12.44159> not available
(Font) size <12> substituted on input line 465.

LaTeX Font Warning: Font shape `OMS/cmsy/m/n' in size <12.44159> not available
(Font) size <12> substituted on input line 465.

LaTeX Font Warning: Font shape `OMX/cmex/m/n' in size <12.44159> not available
(Font) size <12> substituted on input line 465.

LaTeX Font Warning: Font shape `U/msa/m/n' in size <12.44159> not available
(Font) size <12> substituted on input line 465.

LaTeX Font Warning: Font shape `U/msb/m/n' in size <12.44159> not available
(Font) size <12> substituted on input line 465.

LaTeX Font Warning: Font shape `U/wasy/m/n' in size <12.44159> not available
(Font) size <12> substituted on input line 465.

LaTeX Font Warning: Font shape `U/stmry/m/n' in size <12.44159> not available
(Font) size <12> substituted on input line 465.

[1]
Overfull \hbox (21.5593pt too wide) in paragraph at lines 523--523

[]/[email protected]/Chapter$ $2.$ $The Prob-lem With Con-cur-rency 

Overfull \hbox (16.4593pt too wide) in paragraph at lines 534--534 /ptmr8t/very_important_count

Overfull \hbox (16.4593pt too wide) in paragraph at lines 534--534 /ptmr8t/very_important_count

Overfull \hbox (16.4593pt too wide) in paragraph at lines 534--534 /ptmr8t/very_important_count

Overfull \hbox (16.4593pt too wide) in paragraph at lines 534--534 /ptmr8t/very_important_count

Overfull \hbox (16.4593pt too wide) in paragraph at lines 534--534 /ptmr8t/very_important_count

Overfull \hbox (16.4593pt too wide) in paragraph at lines 534--534 /ptmr8t/very_important_count

Overfull \hbox (16.4593pt too wide) in paragraph at lines 534--534 /ptmr8t/very_important_count

Overfull \hbox (16.4593pt too wide) in paragraph at lines 534--534 /ptmr8t/very_important_count

Overfull \hbox (16.4593pt too wide) in paragraph at lines 538--538 /ptmr8t/very_important_count

Overfull \hbox (16.4593pt too wide) in paragraph at lines 538--538 /ptmr8t/very_important_count

Overfull \hbox (16.4593pt too wide) in paragraph at lines 538--538 /ptmr8t/very_important_count

Overfull \hbox (16.4593pt too wide) in paragraph at lines 538--538 /ptmr8t/very_important_count

Overfull \hbox (16.4593pt too wide) in paragraph at lines 538--538 /ptmr8t/very_important_count

Overfull \hbox (16.4593pt too wide) in paragraph at lines 538--538 /ptmr8t/very_important_count

Overfull \hbox (16.4593pt too wide) in paragraph at lines 538--538 /ptmr8t/very_important_count

Overfull \hbox (16.4593pt too wide) in paragraph at lines 538--538 /ptmr8t/very_important_count
[2] [3] [4]
Underfull \hbox (badness 5637) in paragraph at lines 700--705 []/ptmr8t/This works per-fectly for [][][]/ptmri8t/UP [][][] /ptmr8t/as well: t he spin lock van-ishes, and this macro sim-ply be-comes
! Illegal unit of measure (replaced by filll).
<argument> <5:block^^I><5:block^^I>L

                                    ocking in the Linux Kernel</5:block></5:...
l.752      </fo:block></fo:block>
                                 </fo:block></fo:flow></fo:page-sequence><fo...

?
! Emergency stop.
<argument> <5:block^^I><5:block^^I>L

                                    ocking in the Linux Kernel</5:block></5:...
l.752      </fo:block></fo:block>
                                 </fo:block></fo:flow></fo:page-sequence><fo...

! ==> Fatal error occurred, the output PDF file is not finished! Transcript written on tmp.log.
make[1]: *** [Documentation/DocBook/kernel-locking.pdf] Error 1
make: *** [pdfdocs] Error 2

XMLTO Documentation/DocBook/wanbook.ps
Making portrait pages on USletter paper (8.5inx11in)
This is TeX, Version 3.14159 (Web2C 7.4.5)
(./tmp.fo
LaTeX2e <2001/06/01>
Babel <v3.7h> and hyphenation patterns for american, french, german, ngerman, n ohyphenation, loaded.
xmltex version: 2002/06/25 v1.9 (Exp):
(/usr/share/texmf/tex/xmltex/xmltex.cfg)
No File: tmp.cfg (/usr/share/texmf/tex/xmltex/passivetex/fotex.xmt) (/usr/share/texmf/tex/latex/base/article.cls
Document Class: article 2001/04/21 v1.4e Standard LaTeX document class (/usr/share/texmf/tex/latex/base/size10.clo)) (/usr/share/texmf/tex/xmltex/passivetex/fotex.sty
)
No file tmp.aux.
(/usr/share/texmf/tex/latex/cyrillic/t2acmr.fd) (/usr/share/texmf/tex/latex/base/ts1cmr.fd) (/usr/share/texmf/tex/latex/psnfss/t1ptm.fd)
No file tmp.out.
No file tmp.out.
INFO: Using normal, i.e. nonfrench-spacing in document (/usr/share/texmf/tex/latex/psnfss/t1phv.fd) (/usr/share/texmf/tex/latex/psnfss/t1pcr.fd) [1] (/usr/share/texmf/tex/latex/psnfss/ts1ptm.fd) [2] (/usr/share/texmf/tex/latex/amsfonts/umsa.fd) (/usr/share/texmf/tex/latex/amsfonts/umsb.fd) (/usr/share/texmf/tex/latex/wasysym/uwasy.fd) (/usr/share/texmf/tex/latex/misc/ustmry.fd) [3]

LaTeX Font Warning: Font shape `OT1/cmr/m/n' in size <12.44159> not available
(Font) size <12> substituted on input line 328.

LaTeX Font Warning: Font shape `OML/cmm/m/it' in size <12.44159> not available
(Font) size <12> substituted on input line 328.

LaTeX Font Warning: Font shape `OMS/cmsy/m/n' in size <12.44159> not available
(Font) size <12> substituted on input line 328.

LaTeX Font Warning: Font shape `OMX/cmex/m/n' in size <12.44159> not available
(Font) size <12> substituted on input line 328.

LaTeX Font Warning: Font shape `U/msa/m/n' in size <12.44159> not available
(Font) size <12> substituted on input line 328.

LaTeX Font Warning: Font shape `U/msb/m/n' in size <12.44159> not available
(Font) size <12> substituted on input line 328.

LaTeX Font Warning: Font shape `U/wasy/m/n' in size <12.44159> not available
(Font) size <12> substituted on input line 328.

LaTeX Font Warning: Font shape `U/stmry/m/n' in size <12.44159> not available
(Font) size <12> substituted on input line 328.

[1]
Overfull \hbox (22.13274pt too wide) in paragraph at lines 384--384 []\T1/phv/b/n/24.8832 Chapter$ $2.$ $Known Bugs And As-sump-tions

! LaTeX Error: Something's wrong--perhaps a missing \item.

See the LaTeX manual or LaTeX Companion for explanation. Type H <return> for immediate help.
...

l.386 ...o:inline></fo:block></fo:list-item-label>

                                                  <fo:list-item-body start-i...

?
! Emergency stop.
...

l.386 ...o:inline></fo:block></fo:list-item-label>

                                                  <fo:list-item-body start-i...

Output written on tmp.dvi (4 pages, 14876 bytes). Transcript written on tmp.log.
make[1]: *** [Documentation/DocBook/wanbook.ps] Error 1
make: *** [psdocs] Error 2

#2 lore raw
In reply to Jeff Garzik

hoi :)

Quoted 2 lines · Jeff Garzik

In each failing case, I can use "db2ps" or "db2pdf" to successfully convert the XML file, whereas xmlto fails.

yes, passivetex (which is used by xmlto to process XML-FO) is not as stable as I thought.
It breaks at strange times but I did not yet had the energy to really look into it.
So we probably have to support db2pdf/ps again.

Quoted 2 lines

* Can you make it easy to change the paper size to something custom, like 6x9in ?

you should be able to put the following lines into stylesheet.xsl:
<param name="paper.width">6in</param>
<param name="paper.height">11in</param>

would it be easy enough if I provided some commented out entries? (well the above only works for xmlto, I don't know how to set the paper size for db2*)

Quoted 2 lines

* Is there an example somewhere describing how to insert graphics (figures and charts) ?

you can insert graphics with <mediaobject><imageobject>
<imagedata fileref="blah.png" format="PNG"/> </imageobject></mediaobject>
(See http://www.faqs.org/docs/docbook/html/mediaobject.html)

The above generates an <img src="blah.png"> in HTML mode. Is that what you want?

Signature · 1 line
Martin Waitz
#3 lore raw
Quoted 4 lines · Martin Waitz

hoi :)

On Tue, May 31, 2005 at 02:31:23PM -0400, Jeff Garzik wrote:

Quoted 8 lines
Quoted 1 line

In each failing case, I can use "db2ps" or "db2pdf" to successfully convert the XML file, whereas xmlto fails.

yes, passivetex (which is used by xmlto to process XML-FO) is not as stable as I thought.
It breaks at strange times but I did not yet had the energy to really look into it.
So we probably have to support db2pdf/ps again.

Cool, just wanted to make sure it got noticed and fixed.

Quoted 8 lines
Quoted 1 line

* Can you make it easy to change the paper size to something custom, like 6x9in ?

you should be able to put the following lines into stylesheet.xsl:
<param name="paper.width">6in</param>
<param name="paper.height">11in</param>

would it be easy enough if I provided some commented out entries?

don't bother. I was just curious for my own knowledge.

Quoted 2 lines

(well the above only works for xmlto, I don't know how to set the paper size for db2*)

Yeah, as I have discovered :/

Quoted 11 lines
Quoted 1 line

* Is there an example somewhere describing how to insert graphics (figures and charts) ?

you can insert graphics with <mediaobject><imageobject>
<imagedata fileref="blah.png" format="PNG"/> </imageobject></mediaobject>
(See http://www.faqs.org/docs/docbook/html/mediaobject.html)

The above generates an <img src="blah.png"> in HTML mode. Is that what you want?

Yep!

I was curious how to include images (and figures) in the kernel docbook docs. The above example and URL were more than enough to get me going.

Thanks,

Jeff