[yocto] Problems building documentation for bitbake 1.17.0

[Rifenbark, Scott M]

Glad it is working.  Yes – there is quite a delta between “master” and 1.17.0 in the way the manual is generated.

Scott

From: Patrick Doyle [mailto:wpdster at gmail.com]
Sent: Tuesday, March 25, 2014 9:48 AM
To: Rifenbark, Scott M
Cc: yocto at yoctoproject.org
Subject: Re: [yocto] Problems building documentation for bitbake 1.17.0

That's the ticket…. thanks.

Installing dblatex and/or xmlto made everything work (and work much faster!).  1.17.0 installs fine (with python setup.py install --user) and "make DOC=user-manual" works for master.  setup still doesn't work on master, probably because doc/manual/thml/* no longer exists:

      data_files = [("share/bitbake", glob("conf/*") + glob("classes/*")),
                  ("share/doc/bitbake-%s/manual" % __version__, glob("doc/manual/html/*"))],

--wpd


On Tue, Mar 25, 2014 at 12:23 PM, Rifenbark, Scott M <scott.m.rifenbark at intel.com<mailto:scott.m.rifenbark at intel.com>> wrote:
Hmm… I can the following on Ubuntu 12.04:

$ git clone git://git.openembedded.org/bitbake<http://git.openembedded.org/bitbake>
$ cd bitbake
$ make DOC=user-manual
Builds both HTML and PDF fine.  Assumes the “master” branch.
I have the make, xsltproc, docbook-utils, fop, dblatex, and xmlto packages on my host build machine.
Scott




From: Patrick Doyle [mailto:wpdster at gmail.com<mailto:wpdster at gmail.com>]
Sent: Tuesday, March 25, 2014 8:30 AM
To: Rifenbark, Scott M
Cc: yocto at yoctoproject.org<mailto:yocto at yoctoproject.org>
Subject: Re: [yocto] Problems building documentation for bitbake 1.17.0

I poked around some more after sending my email (instead of doing the work I was supposed to be doing) and found that, by ignoring the docbook messages and just letting the setup complete for 1.17.0, it worked (once I apt-got another package or two: xsltproc, libxml2-utils, fop, maybe others).  So I now have a doc/manual/html directory for 1.17.0.

I still can't build the docs (with "make DOC=user-manual") on master though.  It fails to build user-manual.pdf:

http://docbook.sourceforge.net/release/xsl/current/common/en.xml:188: parser error : Premature end of data in tag l10n line 2
<l:gentext key="listof
                      ^
[warning] /usr/bin/fop: Unable to locate servlet-api in /usr/share/java
Default page-height set to: 11in
Default page-width set to: 8.26in
Exception
org.apache.fop.apps.FOPException: String index out of range: 0
java.lang.StringIndexOutOfBoundsException: String index out of range: 0


******** Creating Tarball of document files

cd user-manual; tar -cvzf user-manual.tgz user-manual-style.css user-manual.html user-manual.pdf figures/bitbake-title.png; cd ..
user-manual-style.css
user-manual.html
tar: user-manual.pdf: Cannot stat: No such file or directory
figures/bitbake-title.png
tar: Exiting with failure status due to previous errors

I'm not to sure what to make of this :-)
--wpd


On Tue, Mar 25, 2014 at 10:38 AM, Rifenbark, Scott M <scott.m.rifenbark at intel.com<mailto:scott.m.rifenbark at intel.com>> wrote:
I created a fresh clone of the upstream BB repository, checked out the 1.17.0 tag and cannot make the user-manual.  I don’t think the ability to make user-manual was in place at the time 1.17.0 tag happened.  I am just guessing here though.

Scott

From: yocto-bounces at yoctoproject.org<mailto:yocto-bounces at yoctoproject.org> [mailto:yocto-bounces at yoctoproject.org<mailto:yocto-bounces at yoctoproject.org>] On Behalf Of Patrick Doyle
Sent: Tuesday, March 25, 2014 5:58 AM
To: yocto at yoctoproject.org<mailto:yocto at yoctoproject.org>
Subject: [yocto] Problems building documentation for bitbake 1.17.0

Hello all,

I just tried

$ git clone git://git.openembedded.org/bitbake<http://git.openembedded.org/bitbake>
$ cd bitbake
$ git checkout 1.17.0
$ python setup.py install

and that failed with an infinite (well, I hit ^C before I found out for real) stream of messages of the form:

http://docbook.sourceforge.net/release/xsl/current/common/en.xml:207: parser error : Extra content at the end of the document
ĞğĠġĢģƓɠǤǥǦǧǴǵḠḡHhĤĥĦħȞȟɦḢḣḤḥḦḧḨḩḪḫ
                                                                               ^

I tried this on a Ubuntu 12.04 LTS 64 bit machine.  Am I missing a particular dependency?  Is this a known problem (with an obvious solution?)  The Google doesn't tell me anything obvious about "docbook extra content at end of document"  (I didn't try searching for the string of random characters that follows that.  Perhaps I should try.)

I get the same error when executing "make DOC=user-manual" on the master branch (note that setup.py doesn't work right now on master), so I'm inclined to believe the problem is at my end.  I'm just not sure where to start looking for a solution.  So I figured I'd ask.

--wpd



-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.yoctoproject.org/pipermail/yocto/attachments/20140325/c20882ad/attachment.html>