Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 151386 - Gentoo handbook 2006.1 does not have a pdf version available, and the handbook is not in portage to generate & print yourself
Summary: Gentoo handbook 2006.1 does not have a pdf version available, and the handboo...
Status: RESOLVED INVALID
Alias: None
Product: [OLD] Docs on www.gentoo.org
Classification: Unclassified
Component: Other documents (show other bugs)
Hardware: All Linux
: High enhancement (vote)
Assignee: Docs Team
URL: http://www.gentoo.org/doc/en/handbook...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2006-10-14 13:53 UTC by corey
Modified: 2006-10-14 17:41 UTC (History)
0 users

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description corey 2006-10-14 13:53:59 UTC
User-Agent:       Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.8.0.4) Gecko/20060628 Galeon/2.0.0 Firefox/1.5.0.4
Build Identifier: 

The gentoo handbook 2001.6 currently does not have a pdf version available from
the web site.  There is a comment about a pdf version "being developed", and
some comments about how if instead of creating a whole handbook with all the
sections for each platoform (like they did for html), they created a pdf for all
the combinations of possible optional sections, it would be "wasting resources".
 However this comment was posted over a year ago, and after a year of checking,
i thought it was time I create a "report" :)

pdf versions are important because when html documents are printed, they cannot
have table of contests with valid page numbers.  I.E. if it's large, you can't
navigate in a printed copy of a html document.

Anyway, if the concern is the space required for the platform specific pdfs,
then one could make a "gentoo-handbook" ebuild that downloads the sources and
prints it for your platform.  (and installs all the dependancies for the text
utils (i tried to download and compile it myself and was unable to figure what
all text utils i was supposed to have installed)).

It could even be one platform independant ebuild that would make itself platform
specific by grepping /etc/make.conf for "CHOST" before compiling the document.

Reproducible: Always

Steps to Reproduce:
1.emerge search handbook
2.
3.
Actual Results:  
nothing returned

Expected Results:  
it would have been nice if it had said "gentoo-handbook-2006.1" :)
Comment 1 nm (RETIRED) gentoo-dev 2006-10-14 17:41:45 UTC
PDFs are available on the release media for each arch.

There is a printable, all-in-one version of the handbook, as well as a few styles of hyperlinked sectioned handbooks.

the idea of documentation ebuilds is an old one -- won't happen. too many changes happen for ebuilds ever to make it out of package.mask until the doc in question is far too outdated. ebuilds can't keep up with the frequency of changes.