[yocto] Problems building documentation for bitbake 1.17.0

[Patrick Doyle]

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

>  Hmm… I can the following on Ubuntu 12.04:
>
>
>
> $ git clone git://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]
> *Sent:* Tuesday, March 25, 2014 8:30 AM
> *To:* Rifenbark, Scott M
> *Cc:* 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> 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/175ace5f/attachment.html>