[OpenAFS-Doc] Final (from Latex) pdf's and html's available

[ted creedon]

The many steps are only to convert the IBM.htm into editable Latex. IBM uses
quite a variety of special characters in their text. 

This is a one time conversion.

Kerberos V and continuing maintenance scripts are not covered well in the
documents so a combination of text and commands cut and pasted into a \begin
{alltt} .... \end{alltt} can be done without worrying about the formatting.
I'll probably add Russ's tools in as needed. I'll probably replace the IBM
convention of <machine name> with a shell variable $S so commands can be cut
and directly pasted into an xterm.

Currently I am editing the Latex documents directly and incorporating other
materials into my documents.

Piece of cake.

I'm using html and pdf generated from these Latex source documents. 

I prefer to:
 "acroread auarf003.pdf auagd003.pdf auqbg003.pdf auusg003.pdf&"

All 4 Unix manuals are in one window and for once I have readable, linked,
searchable, uptodate documentation. (The html is not as visually correct as
the pdf but it does browse).

When something better arrives....

tedc

-----Original Message-----
From: openafs-doc-admin@openafs.org [mailto:openafs-doc-admin@openafs.org]
On Behalf Of Esther Filderman
Sent: Monday, June 27, 2005 7:56 PM
To: openafs-doc@openafs.org
Subject: Re: [OpenAFS-Doc] Final (from Latex) pdf's and html's available 


Ok, look.  There are certain requirements here:

1) We should be using one system.

2) It should be simple enough for a non-programmer to use. [Like, say,
   ME.]  It should not require "special instructions" to update files.

3) It *MUST* generate, at the minimum, both some sort of "printable
   format" and html.  HTML is a *must* for the website.


I would rather try to preserve the conversion that Ted has done but I am not
convinced that LaTex is the right format to be using for everything, mostly
because generating solid HTML seems to be such a problem.

There are tools to convert LaTex to DocBook [amusingly, there are tools to
convert POD *to* LaTex but not the other way, that I can find].  Perhaps
that's the way we should go.


I'm still researching DocBook & POD.  I've also still got pneumonia and am
not up to speed on life.


e.

_______________________________________________
OpenAFS-doc mailing list
OpenAFS-doc@openafs.org
https://lists.openafs.org/mailman/listinfo/openafs-doc