DocBook build failures, and graphical figures

DocBook build failures, and graphical figures

[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.

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

Re: DocBook build failures, and graphical figures

[Jeff Garzik]

[-- Attachment #1: Type: text/plain, Size: 473 bytes --]

Jeff Garzik wrote:
> 
> 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




[-- Attachment #2: output-pdfdocs.txt --]
[-- Type: text/plain, Size: 5079 bytes --]

  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
[]/phvb8t@24.8832pt/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

[-- Attachment #3: output-psdocs.txt --]
[-- Type: text/plain, Size: 3283 bytes --]

  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

Re: DocBook build failures, and graphical figures

[Martin Waitz]

[-- Attachment #1: Type: text/plain, Size: 1220 bytes --]

hoi :)

On Tue, May 31, 2005 at 02:31:23PM -0400, Jeff Garzik wrote:
> 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.

> * 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*)

> * 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?

-- 
Martin Waitz

[-- Attachment #2: Digital signature --]
[-- Type: application/pgp-signature, Size: 189 bytes --]

Re: DocBook build failures, and graphical figures

[Jeff Garzik]

Martin Waitz wrote:
> hoi :)
> 
> On Tue, May 31, 2005 at 02:31:23PM -0400, Jeff Garzik wrote:
> 
>>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.


>>* 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.


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

Yeah, as I have discovered :/


>>* 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