<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://bugzilla.yoctoproject.org/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.6"
          urlbase="https://bugzilla.yoctoproject.org/"
          
          maintainer="it-coreprojects-helpdesk@linuxfoundation.org"
>

    <bug>
          <bug_id>593</bug_id>
          
          <creation_ts>2010-12-14 11:02:21 +0000</creation_ts>
          <short_desc>bitbake manual fails to build</short_desc>
          <delta_ts>2011-05-13 10:59:19 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>9</classification_id>
          <classification>Documentation</classification>
          <product>Reference</product>
          <component>handbook</component>
          <version>1.0</version>
          <rep_platform>x86</rep_platform>
          <op_sys>Multiple</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>High</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>1.0 PointRelease</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Darren Hart">dvhart</reporter>
          <assigned_to name="Darren Hart">dvhart</assigned_to>
          <cc>ke.yu</cc>
    
    <cc>poky.doc.watcher</cc>
    
    <cc>poky.watcher</cc>
    
    <cc>richard.purdie</cc>
    
    <cc>sgw</cc>
          
          
          <cf_os>---</cf_os>
          <cf_regression_type>---</cf_regression_type>
          
          <cf_docchange>---</cf_docchange>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>11157</commentid>
    <comment_count>0</comment_count>
    <who name="Darren Hart">dvhart</who>
    <bug_when>2010-12-14 11:02:21 +0000</bug_when>
    <thetext>This is for the bitbake manual, but there isn&apos;t an appropriate component.

$ make
XMLLINT ./usermanual.xml
XMLTO pdf ./usermanual.xml
Making portrait pages on letter paper (215.9mmx279.4mm)
make: *** [pdf] Error 1

dvhart@doubt:manual$ pwd
/home/dvhart/source/poky.git/bitbake/doc/manual
dvhart@doubt:manual$ tree
.
├── Makefile
├── html.css
├── pdf
└── usermanual.xml

1 directory, 3 files</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>11575</commentid>
    <comment_count>1</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2011-01-28 09:50:13 +0000</bug_when>
    <thetext>I need some time to investigate this bug.  I am getting the same error when I run Make on the manual.  The make file is not the same as for the YP documentation.  It is using xmltex tools.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>12407</commentid>
    <comment_count>2</comment_count>
    <who name="Darren Hart">dvhart</who>
    <bug_when>2011-03-09 11:37:24 +0000</bug_when>
    <thetext>Took a quick look and found that &apos;make txt&apos; succeeds, &apos;make pdf&apos; fails. Adding ps and dvi to the types in the Makefile allows the running of &apos;make ps&apos; or &apos;make dvi&apos;, both of which fail in the same way as pdf. They fail at:

xmlto --extensions -o ./pdf pdf ./usermanual.xml
Making portrait pages on letter paper (215.9mmx279.4mm)

(where pdf is pdf, dvi, or ps, depending on the target).

Enabling DEBUG in the Makefile yields:

This is pdfTeX, Version 3.1415926-1.40.10 (TeX Live 2009/Debian)
 restricted \write18 enabled.
entering extended mode
(./tmp.fo
LaTeX2e &lt;2009/09/24&gt;
Babel &lt;v3.8l&gt; 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 2007/10/19 v1.4h Standard LaTeX document class
(/usr/share/texmf-texlive/tex/latex/base/size10.clo))
(/usr/share/texmf/tex/xmltex/passivetex/fotex.sty
)
No file tmp.aux.
(/usr/share/texmf/tex/latex/tipa/t3ptm.fd)
(/usr/share/texmf-texlive/tex/latex/base/ts1cmr.fd)
(/usr/share/texmf-texlive/tex/latex/psnfss/t1ptm.fd)
(/usr/share/texmf-texlive/tex/context/base/supp-pdf.mkii
[Loading MPS to PDF converter (version 2006.09.02).]
)
No file tmp.out.
No file tmp.out.
INFO: Using normal, i.e. nonfrench-spacing in document
(/usr/share/texmf-texlive/tex/latex/psnfss/t1phv.fd) [1{/var/lib/texmf/fonts/ma
p/pdftex/updmap/pdftex.map}]
(/usr/share/texmf-texlive/tex/latex/psnfss/ts1ptm.fd)
Overfull \hbox (9.40834pt too wide) in paragraph at lines 205--205
[]\T1/ptm/m/n/8 This work is li-censed un-der the Cre-ative Com-mons At-tri-bu-
tion Li-cense. To view a copy of this li-cense, visit []http://creativecommons.
org/licenses/by/2.5/[]
[2] (/usr/share/texmf-texlive/tex/latex/amsfonts/umsa.fd)
(/usr/share/texmf-texlive/tex/latex/amsfonts/umsb.fd)
(/usr/share/texmf-texlive/tex/latex/wasysym/uwasy.fd)
(/usr/share/texmf-texlive/tex/latex/psnfss/t1pcr.fd) [3] [4]

! LaTeX Error: Something&apos;s wrong--perhaps a missing \item.

See the LaTeX manual or LaTeX Companion for explanation.
Type  H &lt;return&gt;  for immediate help.
 ...                                              
                                                  
l.464 ...&quot; hyphenation-remain-character-count=&quot;2&quot;&gt;
                                                  Chapter 1. Introduction&lt;...

? 
! Emergency stop.
 ...                                              
                                                  
l.464 ...&quot; hyphenation-remain-character-count=&quot;2&quot;&gt;
                                                  Chapter 1. Introduction&lt;...

!  ==&gt; Fatal error occurred, no output PDF file produced!
Transcript written on tmp.log.
make: *** [pdf] Error 1


So there appears to be a problem either in our usage of or the implementation of the xmlto tool&apos;s latex mechanism.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>12408</commentid>
    <comment_count>3</comment_count>
    <who name="Darren Hart">dvhart</who>
    <bug_when>2011-03-09 11:53:23 +0000</bug_when>
    <thetext>Using dblatex to do the conversion to pdf, ps, and dvi, but requires the addition of the following packages (on Ubuntu 10.10):

dblatex texlive-bibtex-extra{a} texlive-math-extra{a}

The following patch resolves the issue - but it does require additional packages, which is clearly not ideal. Tested for both txt and pdf targets, which are both affected by the patch.

diff --git a/bitbake/doc/manual/Makefile b/bitbake/doc/manual/Makefile
index a43c025..6a432f8 100644
--- a/bitbake/doc/manual/Makefile
+++ b/bitbake/doc/manual/Makefile
@@ -12,6 +12,7 @@ htmlcss = $(topdir)/html.css
 # htmlcss =
 cleanfiles = $(foreach i,$(types),$(topdir)/$(i))
 
+DEBUG := 1
 ifdef DEBUG
 define command
        $(1)
@@ -45,7 +46,7 @@ endif
        $(call command,xsltproc --stringparam base.dir $@/ $(if $(htmlcssfile),-
 
 $(xmltotypes): $(manual)
-       $(call command,xmlto --extensions -o $(topdir)/$@ $@ $(manual),XMLTO $@ 
+       $(call command,xmlto --with-dblatex --extensions -o $(topdir)/$@ $@ $(ma
 
 clean:
        rm -rf $(cleanfiles)</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>12409</commentid>
    <comment_count>4</comment_count>
    <who name="Darren Hart">dvhart</who>
    <bug_when>2011-03-09 12:03:30 +0000</bug_when>
    <thetext>Even a simple xml file fails to build:

$ cat simple.xml 
&lt;?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot;?&gt;
&lt;!DOCTYPE book PUBLIC &quot;-//OASIS//DTD DocBook XML V4.1.2//EN&quot; &quot;http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd&quot; [
]&gt;
&lt;book lang=&quot;en&quot;&gt;
  &lt;bookinfo&gt;
    &lt;title&gt;Test&lt;/title&gt;
  &lt;/bookinfo&gt;
  &lt;chapter&gt;
    &lt;title&gt;Test chapter&lt;/title&gt;
    &lt;para&gt;Test&lt;/para&gt;
  &lt;/chapter&gt;
&lt;/book&gt;

$ xmlto pdf simple.xml
results in the same output as the bitbake manual including:

! LaTeX Error: Something&apos;s wrong--perhaps a missing \item.

I&apos;m seeing a few of these bugs reported having gone stale with no resolution, perhaps the dblatex solution is the way to go.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>12411</commentid>
    <comment_count>5</comment_count>
    <who name="Darren Hart">dvhart</who>
    <bug_when>2011-03-09 14:06:37 +0000</bug_when>
    <thetext>Patch submitted to poky list. Addition of dblatex dependency considered acceptable.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>12701</commentid>
    <comment_count>6</comment_count>
    <who name="Darren Hart">dvhart</who>
    <bug_when>2011-03-16 08:51:35 +0000</bug_when>
    <thetext>Reopening until the patch is pulled into master.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>12702</commentid>
    <comment_count>7</comment_count>
    <who name="Richard Purdie">richard.purdie</who>
    <bug_when>2011-03-16 09:14:20 +0000</bug_when>
    <thetext>Merged into master: http://git.yoctoproject.org/cgit.cgi/poky/commit/?id=b26640f30a4c80fcedda0d19bcf96ed412062a33</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>13807</commentid>
    <comment_count>8</comment_count>
    <who name="Saul Wold">sgw</who>
    <bug_when>2011-05-13 10:59:19 +0000</bug_when>
    <thetext>Bernard:
http://git.yoctoproject.org/cgit/cgit.cgi/poky/commit/?id=f837ecebc6b6afd3d39192079f607053d5cea010</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>