prerequisite tools for making documentation

prerequisite tools for making documentation

[jfabernathy]

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

Re: prerequisite tools for making documentation

[Andrei Gherzan]

[-- Attachment #1: Type: text/plain, Size: 911 bytes --]

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

On Sun, Jun 24, 2012 at 7:06 PM, jfabernathy <jfabernathy@gmail.com> wrote:

> 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
> yocto@yoctoproject.org
> https://lists.yoctoproject.**org/listinfo/yocto<https://lists.yoctoproject.org/listinfo/yocto>
>

[-- Attachment #2: Type: text/html, Size: 1282 bytes --]

Re: prerequisite tools for making documentation

[Paul Eggleton]

On Sunday 24 June 2012 12:06:14 jfabernathy wrote:
> 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.

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

Re: prerequisite tools for making documentation

[Rifenbark, Scott M]

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: yocto-bounces@yoctoproject.org [mailto:yocto-bounces@yoctoproject.org] On Behalf Of jfabernathy
Sent: Sunday, June 24, 2012 9:06 AM
To: yocto@yoctoproject.org
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
yocto@yoctoproject.org
https://lists.yoctoproject.org/listinfo/yocto

Re: prerequisite tools for making documentation

[Chris Hallinan]

[-- Attachment #1: Type: text/plain, Size: 1144 bytes --]

On Tue, Jul 3, 2012 at 2:25 PM, Rifenbark, Scott M <
scott.m.rifenbark@intel.com> 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: yocto-bounces@yoctoproject.org [mailto:
> yocto-bounces@yoctoproject.org] On Behalf Of jfabernathy
> Sent: Sunday, June 24, 2012 9:06 AM
> To: yocto@yoctoproject.org
> 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.

Thanks,

Chris

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

[-- Attachment #2: Type: text/html, Size: 1674 bytes --]

Re: prerequisite tools for making documentation

[jfabernathy]

[-- Attachment #1: Type: text/plain, Size: 1928 bytes --]

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: yocto-bounces@yoctoproject.org 
[mailto:yocto-bounces@yoctoproject.org] On Behalf Of jfabernathy Sent: 
Sunday, June 24, 2012 9:06 AM To: yocto@yoctoproject.org 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 
yocto@yoctoproject.org https://lists.yoctoproject.org/listinfo/yocto



[-- Attachment #2: Type: text/html, Size: 3262 bytes --]

Re: prerequisite tools for making documentation

[jfabernathy]

[-- Attachment #1: Type: text/plain, Size: 1506 bytes --]

On 07/03/2012 02:57 PM, Chris Hallinan wrote:
> On Tue, Jul 3, 2012 at 2:25 PM, Rifenbark, Scott M 
> <scott.m.rifenbark@intel.com <mailto:scott.m.rifenbark@intel.com>> 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: yocto-bounces@yoctoproject.org
>     <mailto:yocto-bounces@yoctoproject.org>
>     [mailto:yocto-bounces@yoctoproject.org
>     <mailto:yocto-bounces@yoctoproject.org>] On Behalf Of jfabernathy
>     Sent: Sunday, June 24, 2012 9:06 AM
>     To: yocto@yoctoproject.org <mailto:yocto@yoctoproject.org>
>     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.
>
>



[-- Attachment #2: Type: text/html, Size: 3009 bytes --]

Re: prerequisite tools for making documentation

[Robert P. J. Day]

On Tue, 3 Jul 2012, Chris Hallinan wrote:

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

  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
========================================================================

Re: prerequisite tools for making documentation

[McClintock Matthew-B29882]

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

On Tue, Jul 3, 2012 at 2:07 PM, Robert P. J. Day <rpjday@crashcourse.ca> wrote:
> On Tue, 3 Jul 2012, Chris Hallinan wrote:
>
>> I'd also be interested in knowing what host you built it on, as
>> several of us (including myself) have had difficulty building docs.
>
>   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
> ========================================================================
> _______________________________________________
> yocto mailing list
> yocto@yoctoproject.org
> https://lists.yoctoproject.org/listinfo/yocto

Re: prerequisite tools for making documentation

[Rifenbark, Scott M]

[-- Attachment #1: Type: text/plain, Size: 1773 bytes --]

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:jfabernathy@gmail.com]
Sent: Tuesday, July 03, 2012 11:59 AM
To: Chris Hallinan
Cc: Rifenbark, Scott M; yocto@yoctoproject.org
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 <scott.m.rifenbark@intel.com<mailto:scott.m.rifenbark@intel.com>> 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: yocto-bounces@yoctoproject.org<mailto:yocto-bounces@yoctoproject.org> [mailto:yocto-bounces@yoctoproject.org<mailto:yocto-bounces@yoctoproject.org>] On Behalf Of jfabernathy
Sent: Sunday, June 24, 2012 9:06 AM
To: yocto@yoctoproject.org<mailto:yocto@yoctoproject.org>
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.



[-- Attachment #2: Type: text/html, Size: 5807 bytes --]

Re: prerequisite tools for making documentation

[Rifenbark, Scott M]

[-- Attachment #1: Type: text/plain, Size: 2404 bytes --]

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:jfabernathy@gmail.com]
Sent: Tuesday, July 03, 2012 11:58 AM
To: Rifenbark, Scott M
Cc: yocto@yoctoproject.org
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: yocto-bounces@yoctoproject.org<mailto:yocto-bounces@yoctoproject.org> [mailto:yocto-bounces@yoctoproject.org] On Behalf Of jfabernathy Sent: Sunday, June 24, 2012 9:06 AM To: yocto@yoctoproject.org<mailto:yocto@yoctoproject.org> 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 yocto@yoctoproject.org<mailto:yocto@yoctoproject.org> https://lists.yoctoproject.org/listinfo/yocto


[-- Attachment #2: Type: text/html, Size: 6228 bytes --]

Re: prerequisite tools for making documentation

[Rifenbark, Scott M]

[-- Attachment #1: Type: text/plain, Size: 2770 bytes --]

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

Scott

From: yocto-bounces@yoctoproject.org [mailto:yocto-bounces@yoctoproject.org] On Behalf Of Rifenbark, Scott M
Sent: Tuesday, July 03, 2012 1:03 PM
To: jfabernathy
Cc: yocto@yoctoproject.org
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:jfabernathy@gmail.com]
Sent: Tuesday, July 03, 2012 11:58 AM
To: Rifenbark, Scott M
Cc: yocto@yoctoproject.org
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: yocto-bounces@yoctoproject.org<mailto:yocto-bounces@yoctoproject.org> [mailto:yocto-bounces@yoctoproject.org] On Behalf Of jfabernathy Sent: Sunday, June 24, 2012 9:06 AM To: yocto@yoctoproject.org<mailto:yocto@yoctoproject.org> 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 yocto@yoctoproject.org<mailto:yocto@yoctoproject.org> https://lists.yoctoproject.org/listinfo/yocto


[-- Attachment #2: Type: text/html, Size: 7796 bytes --]