PDF manual support

PDF manual support

[Rifenbark, Scott M]

I am seriously considering dumping the PDF manuals for the 1.8 release.  The PDF output is less than good and there seems to have been no enthusiasm for this form during the past 4 years.  Comments?

Scott

Scott Rifenbark
Intel Corporation
Yocto Project Documentation
503.712.2702
503.341.0418 (cell)

Re: PDF manual support

[Burton, Ross]

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

On 13 January 2015 at 14:28, Rifenbark, Scott M <scott.m.rifenbark@intel.com
> wrote:

> I am seriously considering dumping the PDF manuals for the 1.8 release.
> The PDF output is less than good and there seems to have been no enthusiasm
> for this form during the past 4 years.  Comments?
>

Assuming that the source remains in DocBook then anyone who wants a
printable copy will be able to generate the PDFs themselves, so I don't see
a massive problem with this myself.

Ross

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

Re: PDF manual support

[Rifenbark, Scott M]

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

Source will remain in DocBook.  Probably going to migrate to DocBook 5 as it is becoming the standard.

From: Burton, Ross [mailto:ross.burton@intel.com]
Sent: Tuesday, January 13, 2015 6:32 AM
To: Rifenbark, Scott M
Cc: Yocto discussion list
Subject: Re: [yocto] PDF manual support


On 13 January 2015 at 14:28, Rifenbark, Scott M <scott.m.rifenbark@intel.com<mailto:scott.m.rifenbark@intel.com>> wrote:
I am seriously considering dumping the PDF manuals for the 1.8 release.  The PDF output is less than good and there seems to have been no enthusiasm for this form during the past 4 years.  Comments?

Assuming that the source remains in DocBook then anyone who wants a printable copy will be able to generate the PDFs themselves, so I don't see a massive problem with this myself.

Ross

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

Re: PDF manual support

[Trevor Woerner]

On 01/13/15 09:28, Rifenbark, Scott M wrote:
> I am seriously considering dumping the PDF manuals for the 1.8 release.  The PDF output is less than good and there seems to have been no enthusiasm for this form during the past 4 years.  Comments?

I tend to generate PDFs from git://git.yoctoproject.org/yocto-docs and
read those. So as long as I can still generate these on my own I'll be
okay with whatever changes work for you.

Re: PDF manual support

[Rifenbark, Scott M]

Trevor, 

Are you generating those on your own or are you using the "pdf:" target from the Makefile that is currently part of the repo?

>-----Original Message-----
>From: Trevor Woerner [mailto:twoerner@gmail.com]
>Sent: Tuesday, January 13, 2015 6:52 AM
>To: Rifenbark, Scott M; Yocto discussion list
>Subject: Re: [yocto] PDF manual support
>
>On 01/13/15 09:28, Rifenbark, Scott M wrote:
>> I am seriously considering dumping the PDF manuals for the 1.8 release.  The
>PDF output is less than good and there seems to have been no enthusiasm for
>this form during the past 4 years.  Comments?
>
>I tend to generate PDFs from git://git.yoctoproject.org/yocto-docs and read
>those. So as long as I can still generate these on my own I'll be okay with
>whatever changes work for you.

Re: PDF manual support

[Trevor Woerner]

On 01/13/15 09:57, Rifenbark, Scott M wrote:
> Are you generating those on your own or are you using the "pdf:" target from the Makefile that is currently part of the repo?

I'm using the pdf target from the Makefile:

    $ make pdf DOC=dev-manual

usually by running:

   
https://github.com/twoerner/meta-trevor/blob/master/misc/build_yocto_docs.sh

Re: PDF manual support

[Rifenbark, Scott M]

I guess I could leave that target in the Makefile but remove it from the "all:" target.  So, you would have to specifically call out that target to make PDF versions (e.g. make pdf DOC=<manual>).

>-----Original Message-----
>From: Trevor Woerner [mailto:twoerner@gmail.com]
>Sent: Tuesday, January 13, 2015 7:23 AM
>To: Rifenbark, Scott M; Yocto discussion list
>Subject: Re: [yocto] PDF manual support
>
>On 01/13/15 09:57, Rifenbark, Scott M wrote:
>> Are you generating those on your own or are you using the "pdf:" target
>from the Makefile that is currently part of the repo?
>
>I'm using the pdf target from the Makefile:
>
>    $ make pdf DOC=dev-manual
>
>usually by running:
>
>
>https://github.com/twoerner/meta-
>trevor/blob/master/misc/build_yocto_docs.sh

Re: PDF manual support

[Chris Hallinan]

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

On Tue, Jan 13, 2015 at 9:28 AM, Rifenbark, Scott M <
scott.m.rifenbark@intel.com> wrote:

> I am seriously considering dumping the PDF manuals for the 1.8 release.
> The PDF output is less than good and there seems to have been no enthusiasm
> for this form during the past 4 years.  Comments?
>

Gosh, am I the only one that still uses PDF manuals?  I like the 'P' part
of PDFs - standalone (no internet) and searchable.  BTW, I have
occasionally tried building them, without much success.  I'm sure it's a
host compatibility issue, and admittedly, I haven't spent much time trying
to get it working.  Please don't delete support for them ;)

-Chris



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

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

Re: PDF manual support

[Rifenbark, Scott M]

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

I can leave them in there as a target for the Makefile.  But, they do not look pretty.  They will be created if you run them from the Makefile.

From: Chris Hallinan [mailto:challinan@gmail.com]
Sent: Tuesday, January 13, 2015 7:32 AM
To: Rifenbark, Scott M
Cc: Yocto discussion list
Subject: Re: [yocto] PDF manual support

On Tue, Jan 13, 2015 at 9:28 AM, Rifenbark, Scott M <scott.m.rifenbark@intel.com<mailto:scott.m.rifenbark@intel.com>> wrote:
I am seriously considering dumping the PDF manuals for the 1.8 release.  The PDF output is less than good and there seems to have been no enthusiasm for this form during the past 4 years.  Comments?

Gosh, am I the only one that still uses PDF manuals?  I like the 'P' part of PDFs - standalone (no internet) and searchable.  BTW, I have occasionally tried building them, without much success.  I'm sure it's a host compatibility issue, and admittedly, I haven't spent much time trying to get it working.  Please don't delete support for them ;)

-Chris



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

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