Return-Path: <braam_at_cs.cmu.edu>
Received: from localhost (braam_at_localhost)
	by carissimi.coda.cs.cmu.edu (8.8.7/8.8.7) with SMTP id LAA01207;
	Wed, 29 Jul 1998 11:51:58 -0400
X-Authentication-Warning: carissimi.coda.cs.cmu.edu: braam owned process doing -bs
Date: Wed, 29 Jul 1998 11:51:58 -0400 (EDT)
From: "Peter J. Braam" <braam_at_cs.cmu.edu>
X-Sender: braam_at_carissimi.coda.cs.cmu.edu
Reply-To: "Peter J. Braam" <braam_at_cs.cmu.edu>
To: Coda Documentation Volunteers -- Magosanyi Arpad <mag_at_bunuel.tii.matav.hu>,
        Jyh-shing Chen <jyhshing_at_jencourt.com>
cc: linux-coda_at_cs.cmu.edu
Subject: Re: which is the documentation source?
In-Reply-To: <19980728181459.A8699_at_bunuel.tii.matav.hu>
Message-ID: <Pine.LNX.3.96.980729114159.1076N-100000_at_carissimi.coda.cs.cmu.edu>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Content-Transfer-Encoding: QUOTED-PRINTABLE


Hi Magosanyi,

We do the documentation in SGML (like Linux HOWTOs).  It would be
marvellous if you made updates to the SGML files and sent us patches.=20

I'm away from my office until Friday and I will try to remember to send
you the source of the documentation when I get back.  We have not
previously released the sources to the documentation, and I will have to
make a few enquiries about copyright to comply with red-tape issues here -
I don't expect problems.

Thanks for your offer!  Chen is working on a HOWTO, perhaps the two of you
can team up - I would hope that the manual will contain both summary and
detailed instructions for setting up and maintaining systems, as well as
detailed instructions to explain the use of tools like repair and volutil
to users. An introductory tour will be very useful.

Also a FAQ is needed with frequently asked sysad questions. Perhaps we can
give that a shot.

The HOWTO could point out things like the sources, summary of install
(e.g. that you need a kernel module as well as user level code). It should
also give summary requirements (like don't run this on Linux PalmPilot)=20
and email list information etc.=20


- Peter -

On Tue, 28 Jul 1998, Magosanyi Arpad wrote:

> Hi!
>=20
> I have noticed that the coda documentation is outdated in some places.
> I am willing to enhance it somehow if someone tells me where is the sourc=
e.
> It looks like that the source isn't included in the distribution...
> Or should I modify the html one?
> =20
> --=20
> GNU GPL: csak tiszta forr=E1sb=F3l
>=20