[yocto] Problems building documentation for bitbake 1.17.0

[Patrick Doyle]

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> 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] *On Behalf Of *Patrick Doyle
> *Sent:* Tuesday, March 25, 2014 5:58 AM
> *To:* 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
>
> $ 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/f1ea97e1/attachment.html>