[OpenAFS-Doc] docbook

ted creedon tcreedon@easystreet.com
Tue, 23 Aug 2005 08:07:26 -0700


This is a multi-part message in MIME format.

------=_NextPart_000_008C_01C5A7B9.B34AF6B0
Content-Type: text/plain;
	charset="us-ascii"
Content-Transfer-Encoding: 7bit

Looks like it would be easier to re-start with cleaned up IBM.htm. 
 
Someone should try the release notes, that's the smallest file.
 
tedc

  _____  

From: openafs-doc-admin@openafs.org [mailto:openafs-doc-admin@openafs.org]
On Behalf Of renato arruda
Sent: Tuesday, August 23, 2005 2:27 AM
To: openafs-doc@openafs.org
Subject: [OpenAFS-Doc] docbook


The PHP project uses docbook for their documentation and they have a pretty
straight forward documentation on how their documentation system works. I
think it might be worth taking a look. Doesnt seem to be too hard to
implement or require a steep learning curve for those writing the
documentation for the first time.

http://doc.php.net/php/dochowto/index.php
http://www.docbook.org/

It doesnt look very appropriate for man pages though. Anyhow, just wanted
drop the link and see if that helps to have an idea on what could be done.

-Renato


------=_NextPart_000_008C_01C5A7B9.B34AF6B0
Content-Type: text/html;
	charset="us-ascii"
Content-Transfer-Encoding: quoted-printable

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML><HEAD>
<META http-equiv=3DContent-Type content=3D"text/html; =
charset=3Dus-ascii">
<META content=3D"MSHTML 6.00.2900.2722" name=3DGENERATOR></HEAD>
<BODY>
<DIV dir=3Dltr align=3Dleft><FONT face=3DArial color=3D#0000ff =
size=3D2><SPAN=20
class=3D656430515-23082005>Looks like it would be easier to re-start =
with cleaned=20
up IBM.htm. </SPAN></FONT></DIV>
<DIV dir=3Dltr align=3Dleft><FONT face=3DArial color=3D#0000ff =
size=3D2><SPAN=20
class=3D656430515-23082005></SPAN></FONT>&nbsp;</DIV>
<DIV dir=3Dltr align=3Dleft><FONT face=3DArial color=3D#0000ff =
size=3D2><SPAN=20
class=3D656430515-23082005>Someone should try the release notes, that's =
the=20
smallest file.</SPAN></FONT></DIV>
<DIV dir=3Dltr align=3Dleft><FONT face=3DArial color=3D#0000ff =
size=3D2><SPAN=20
class=3D656430515-23082005></SPAN></FONT>&nbsp;</DIV>
<DIV dir=3Dltr align=3Dleft><FONT face=3DArial color=3D#0000ff =
size=3D2><SPAN=20
class=3D656430515-23082005>tedc</SPAN></FONT></DIV><BR>
<DIV class=3DOutlookMessageHeader lang=3Den-us dir=3Dltr align=3Dleft>
<HR tabIndex=3D-1>
<FONT face=3DTahoma size=3D2><B>From:</B> openafs-doc-admin@openafs.org=20
[mailto:openafs-doc-admin@openafs.org] <B>On Behalf Of </B>renato=20
arruda<BR><B>Sent:</B> Tuesday, August 23, 2005 2:27 AM<BR><B>To:</B>=20
openafs-doc@openafs.org<BR><B>Subject:</B> [OpenAFS-Doc]=20
docbook<BR></FONT><BR></DIV>
<DIV></DIV>The PHP project uses docbook for their documentation and they =
have a=20
pretty straight forward documentation on how their documentation system =
works. I=20
think it might be worth taking a look. Doesnt seem to be too hard to =
implement=20
or require a steep learning curve for those writing the documentation =
for the=20
first time.<BR><BR><A=20
href=3D"http://doc.php.net/php/dochowto/index.php">http://doc.php.net/php=
/dochowto/index.php</A><BR><A=20
href=3D"http://www.docbook.org/">http://www.docbook.org/</A><BR><BR>It =
doesnt look=20
very appropriate for man pages though. Anyhow, just wanted drop the link =
and see=20
if that helps to have an idea on what could be=20
done.<BR><BR>-Renato<BR></BODY></HTML>

------=_NextPart_000_008C_01C5A7B9.B34AF6B0--