prerequisite tools for making documentation

I had a need to look at the bitbake manual in the poky/bitbake/doc/manual directory and tried to make pdf. I had all the prerequisites listed in the QS guide. However, I found the make failed due to a number of xml related tools being missing. I installed those and got the pdf manual generated.

Should we add those xml tools to the prerequisites? BTW, I'm using denzil branch and referring to the QS guide 1.2.

Jim A

That would be a good idea in my opinion too as i tried to make doc last week and i ended up dropping this task as i didn't have the time to search for those xml deps.

@g

IMO, we should be separating out the prerequisites for building the documentation into a separate list, since most people don't need to build the documentation. That said, it would be nice if our documentation pre-requisites list was actually complete, so if the list is split I'm all for it :)

Cheers,
Paul

Paul Eggleton
Intel Open Source Technology Centre

Jim,

Do you have a list of what you had to install? I can add this to the QS "Packages" section.

Scott

-----Original Message-----
From: [email protected] [mailto:[email protected]] On Behalf Of jfabernathy
Sent: Sunday, June 24, 2012 9:06 AM
To: [email protected]
Subject: [yocto] prerequisite tools for making documentation

I had a need to look at the bitbake manual in the poky/bitbake/doc/manual directory and tried to make pdf. I had all the prerequisites listed in the QS guide. However, I found the make failed due to a number of xml related tools being missing. I installed those and got the pdf manual generated.

Should we add those xml tools to the prerequisites? BTW, I'm using denzil branch and referring to the QS guide 1.2.

Jim A

_______________________________________________
yocto mailing list
[email protected]
https://lists.yoctoproject.org/listinfo/yocto

I'd also be interested in knowing what host you built it on, as several of us (including myself) have had difficulty building docs.

Thanks,

Chris

Life is like Linux - it never stands still.

I'm running Ubuntu 12.04 LTS.

Jim A

Jim - thanks for the list for Ubuntu. If anyone has knowledge of building the BitBake documentation on Fedora, CentOS, and openSUSE and the packages needed that are not in the QS, please post.

Thanks,
Scott

From: jfabernathy [mailto:[email protected]]
Sent: Tuesday, July 03, 2012 11:59 AM
To: Chris Hallinan
Cc: Rifenbark, Scott M; [email protected]
Subject: Re: [yocto] prerequisite tools for making documentation

On 07/03/2012 02:57 PM, Chris Hallinan wrote:
On Tue, Jul 3, 2012 at 2:25 PM, Rifenbark, Scott M <[email protected]<mailto:[email protected]>> wrote:
Jim,

Do you have a list of what you had to install? I can add this to the QS "Packages" section.

Scott

-----Original Message-----
From: [email protected]<mailto:[email protected]> [mailto:[email protected]<mailto:[email protected]>] On Behalf Of jfabernathy
Sent: Sunday, June 24, 2012 9:06 AM
To: [email protected]<mailto:[email protected]>
Subject: [yocto] prerequisite tools for making documentation

I had a need to look at the bitbake manual in the poky/bitbake/doc/manual directory and tried to make pdf. I had all the prerequisites listed in the QS guide. However, I found the make failed due to a number of xml related tools being missing. I installed those and got the pdf manual generated.

Should we add those xml tools to the prerequisites? BTW, I'm using denzil branch and referring to the QS guide 1.2.

I'd also be interested in knowing what host you built it on, as several of us (including myself) have had difficulty building docs.

I'm running Ubuntu 12.04 LTS.

Jim A

Thanks,

Chris

--
Life is like Linux - it never stands still.

just recently, i whined incessantly about the issue i was having
building PDF docs on my ubuntu 12.04 system,

http://ubuntu.5.n6.nabble.com/quot-Cannot-open-file-sRGB-pf-quot-when-using-quot-fop-quot-to-generate-PDF-td4981668.html

anyone have a suggestion? should i switch javas? if anyone is getting PDFs to build on their ubuntu system, i'd be interested in knowing their setup and package list.

rday

========================================================================
Robert P. J. Day                                 Ottawa, Ontario, CANADA
                        http://crashcourse.ca

Twitter:                                       http://twitter.com/rpjday
LinkedIn:                               http://ca.linkedin.com/in/rpjday
========================================================================

I went through this trying to fix the docs build on a machine and my build script has some clues about what I needed to do:

export PATH=/opt/fop-1.0:$PATH
export PATH=/usr/local/bin:$PATH

which xsltproc

cd documentation

for i in adt-manual dev-manual yocto-project-qs bsp-guide kernel-manual poky-ref-manual; do
make pdf html DOC=$i BRANCH=edison
done

I think I needed a new 'fop' and a new 'xsltproc' - this was on an old build machine (CentOS 5.X) though so things could be different.

-M

*Scott,

I had to go thru the apt log for the day I posted this issues. Below are the packages. I imagine that texlive brought in the last 8 or so.

Jim A

Selecting previously unselected package libxml2-utils.

Selecting previously unselected package docbook-xsl.

Selecting previously unselected package xmlto.

Selecting previously unselected package xmltex.

Selecting previously unselected package texlive. Selecting previously unselected package texlive-bibtex-extra. Selecting previously unselected package preview-latex-style. Selecting previously unselected package texlive-pictures. Selecting previously unselected package texlive-latex-extra. Selecting previously unselected package texlive-math-extra. Selecting previously unselected package dblatex. Selecting previously unselected package texlive-latex-extra-doc. Selecting previously unselected package texlive-pictures-doc. *

-----Original Message----- From: [email protected] [mailto:[email protected]] On Behalf Of jfabernathy Sent: Sunday, June 24, 2012 9:06 AM To: [email protected] Subject: [yocto] prerequisite tools for making documentation I had a need to look at the bitbake manual in the poky/bitbake/doc/manual directory and tried to make pdf. I had all the prerequisites listed in the QS guide. However, I found the make failed due to a number of xml related tools being missing. I installed those and got the pdf manual generated. Should we add those xml tools to the prerequisites? BTW, I'm using denzil branch and referring to the QS guide 1.2. Jim A _______________________________________________ yocto mailing list [email protected] https://lists.yoctoproject.org/listinfo/yocto

For Ubuntu 10.04 I installed dblatex and that installed everything in Jim's list from texlive down (inclusive). I was able to make the BitBake documents after installing dblatex.

Scott

From: jfabernathy [mailto:[email protected]]
Sent: Tuesday, July 03, 2012 11:58 AM
To: Rifenbark, Scott M
Cc: [email protected]
Subject: Re: [yocto] prerequisite tools for making documentation

On 07/03/2012 02:25 PM, Rifenbark, Scott M wrote:

Jim,

Do you have a list of what you had to install? I can add this to the QS "Packages" section.

Scott
Scott,

I had to go thru the apt log for the day I posted this issues. Below are the packages. I imagine that texlive brought in the last 8 or so.

Jim A

Selecting previously unselected package libxml2-utils.

Selecting previously unselected package docbook-xsl.

Selecting previously unselected package xmlto.

Selecting previously unselected package xmltex.

Selecting previously unselected package texlive. Selecting previously unselected package texlive-bibtex-extra. Selecting previously unselected package preview-latex-style. Selecting previously unselected package texlive-pictures. Selecting previously unselected package texlive-latex-extra. Selecting previously unselected package texlive-math-extra. Selecting previously unselected package dblatex. Selecting previously unselected package texlive-latex-extra-doc. Selecting previously unselected package texlive-pictures-doc.

-----Original Message----- From: [email protected]<mailto:[email protected]> [mailto:[email protected]] On Behalf Of jfabernathy Sent: Sunday, June 24, 2012 9:06 AM To: [email protected]<mailto:[email protected]> Subject: [yocto] prerequisite tools for making documentation I had a need to look at the bitbake manual in the poky/bitbake/doc/manual directory and tried to make pdf. I had all the prerequisites listed in the QS guide. However, I found the make failed due to a number of xml related tools being missing. I installed those and got the pdf manual generated. Should we add those xml tools to the prerequisites? BTW, I'm using denzil branch and referring to the QS guide 1.2. Jim A _______________________________________________ yocto mailing list [email protected]<mailto:[email protected]> https://lists.yoctoproject.org/listinfo/yocto

I added dblatex to Ubuntu, Fedora, openSUSE, and CentOS package lists in the YP Quick Start.

Scott

From: [email protected] [mailto:[email protected]] On Behalf Of Rifenbark, Scott M
Sent: Tuesday, July 03, 2012 1:03 PM
To: jfabernathy
Cc: [email protected]
Subject: Re: [yocto] prerequisite tools for making documentation

For Ubuntu 10.04 I installed dblatex and that installed everything in Jim's list from texlive down (inclusive). I was able to make the BitBake documents after installing dblatex.

Scott

From: jfabernathy [mailto:[email protected]]
Sent: Tuesday, July 03, 2012 11:58 AM
To: Rifenbark, Scott M
Cc: [email protected]
Subject: Re: [yocto] prerequisite tools for making documentation

On 07/03/2012 02:25 PM, Rifenbark, Scott M wrote:

Jim,

Do you have a list of what you had to install? I can add this to the QS "Packages" section.

Scott
Scott,

I had to go thru the apt log for the day I posted this issues. Below are the packages. I imagine that texlive brought in the last 8 or so.

Jim A

Selecting previously unselected package libxml2-utils.

Selecting previously unselected package docbook-xsl.

Selecting previously unselected package xmlto.

Selecting previously unselected package xmltex.

Selecting previously unselected package texlive. Selecting previously unselected package texlive-bibtex-extra. Selecting previously unselected package preview-latex-style. Selecting previously unselected package texlive-pictures. Selecting previously unselected package texlive-latex-extra. Selecting previously unselected package texlive-math-extra. Selecting previously unselected package dblatex. Selecting previously unselected package texlive-latex-extra-doc. Selecting previously unselected package texlive-pictures-doc.

-----Original Message----- From: [email protected]<mailto:[email protected]> [mailto:[email protected]] On Behalf Of jfabernathy Sent: Sunday, June 24, 2012 9:06 AM To: [email protected]<mailto:[email protected]> Subject: [yocto] prerequisite tools for making documentation I had a need to look at the bitbake manual in the poky/bitbake/doc/manual directory and tried to make pdf. I had all the prerequisites listed in the QS guide. However, I found the make failed due to a number of xml related tools being missing. I installed those and got the pdf manual generated. Should we add those xml tools to the prerequisites? BTW, I'm using denzil branch and referring to the QS guide 1.2. Jim A _______________________________________________ yocto mailing list [email protected]<mailto:[email protected]> https://lists.yoctoproject.org/listinfo/yocto