Gentoo Logo
Gentoo Spaceship

Note: Due to technical difficulties, the Archives are currently not up to date. GMANE provides an alternative service for most mailing lists.
c.f. bug 424647
List Archive: gentoo-doc
Lists: gentoo-doc: < Prev By Thread Next > < Prev By Date Next >
To: gentoo-doc@g.o
From: "Jeremy C. Reed" <reed@...>
Subject: Re: Regarding handbook/draft/complete
Date: Tue, 17 Jan 2006 09:28:34 -0800 (PST)
On Tue, 17 Jan 2006, Josh wrote:

> PS: Though the very idea of an "in-print" Gentoo book is in many ways absurd, as
> Gentoo is unique among Linux distros for its generally faster-paced, evolving
> nature, these draft handbooks present the best possible approach to actually
> publishing a "dead tree" Gentoo guide--something that would be a first for the
> distro, AFAIK. Given Gentoo's rapidly changing nature (e.g. fundamental pieces
> like Portage and baselayout), the need for a paper Gentoo book might seem
> obviated. But I'm strangely attracted to the idea. It seems more doable now that
> the draft handbooks have less of a specific Gentoo emphasis. I'd certainly be
> interested in seeing Gentoo documentation in print!

Over a year ago, I worked on writing some style sheets that could be used 
with xsltproc to convert the GuideXML documents to LyX format. Then I did 
various editing and formatting to work on a print format. (It is a lot of 
work to convert to a book format; the GuideXML is great for HTML and web 

I also heard from someone who also was working on making the handbook into 
a print format. But now that over a year has passed, I guess not.

One problem I had was that the content (at that time) was constantly 
changing. It was too time consuming for me to merge in my changes, 
regenerate the LyX from the GuideXML each time (especially since that 
would mean losing my later changes), or manually editing both my LyX files 
and my copies of the orginal GuideXML files.

A couple things that would help me:

- have a consistent release of the handbook to base it on (like 2005.1); 
and have a freeze period where I know the handbook would not be updated 
(except for critical fixes). Then plan for that, such as the print book 
will be available (already printed) for 2006.2 (second quarter) by April 

- access to real CVS, so I don't have to use web-based CVS or tarballs to 
merge changes. (Is there publically-available anonymous cvs yet?)

It would be good to survey to see if there is a potential market. Do we 
know at least 100 people would purchase the book? 1000 people? Since 
Gentoo already has a defined community, this would be easy to find out.

Another thing to consider is to make a list of concepts or objectives 
publically available from the LPI and the BSD Certification Group 
(ignoring the BSD specific) to see if any "important" areas are missing 
from the Gentoo (to-be) printed book.

 Jeremy C. Reed

 	  	 	 technical support & remote administration
gentoo-doc@g.o mailing list

Re: Regarding handbook/draft/complete
-- Chris Gianelloni
Regarding handbook/draft/complete
-- Sven Vermeulen
Re: Regarding handbook/draft/complete
-- Josh
Lists: gentoo-doc: < Prev By Thread Next > < Prev By Date Next >
Previous by thread:
Re: Regarding handbook/draft/complete
Next by thread:
Re: Regarding handbook/draft/complete
Previous by date:
Re: Regarding handbook/draft/complete
Next by date:
Re: Regarding handbook/draft/complete

Updated Jun 17, 2009

Summary: Archive of the gentoo-doc mailing list.

Donate to support our development efforts.

Copyright 2001-2013 Gentoo Foundation, Inc. Questions, Comments? Contact us.