[OpenAFS-Doc] docbook conversion of QuickStartUnix

[Russ Allbery]

chas williams - CONTRACTOR <chas@cmf.nrl.navy.mil> writes:

> since there has seen some interest in a docbook conversion, i took a
> stab at converting some of the existing .htm documentation.

> here is a first pass at QuickStartUnix.  its looks pretty good and is
> fully indexed.  generating the .pdf with the full index is very slow so
> you should only do that after making your changes and are producing a
> "final" document.  if someone has a better toolchain for docbook to
> pdf (with index support) i would like to hear about it.

> ftp://ftp.cmf.nrl.navy.mil/pub/chas/openafs/QuickStartUnix.tar.gz

> critiques on the conversion are welcome.  the content is a bit
> dated and otherwise goofy (guaranties).

I like.  There are a few minor problems (I noticed a stray empty bullet,
for instance), but it looks like a generally high-quality conversion and
gets things into a format that would be much easier to work with.

The generated HTML, though, is hideous.  I assume that's just a matter of
finding better DocBook to HTML tools?

-- 
Russ Allbery (rra@stanford.edu)             <http://www.eyrie.org/~eagle/>