From mint-bounce@lists.fishpool.fi  Sun Feb  7 09:28:59 2010
Message-ID: <4B6ECDA0.6060002@online.no>
Date: Sun, 07 Feb 2010 15:26:40 +0100
From: Jo Even Skarstein <joska@online.no>
User-Agent: Thunderbird 2.0.0.23 (X11/20090817)
MIME-Version: 1.0
To: mint <mint@lists.fishpool.fi>
Subject: Re: [MiNT] Yes Crews 1998 MiNT System Calls ?
References: <4B6B3537.3000604@gandon.org> <201002051754.p9510@b.maus.de> <11a6f2b11002062335m462745d8q40cdf75d0021ba7@mail.gmail.com>
In-Reply-To: <11a6f2b11002062335m462745d8q40cdf75d0021ba7@mail.gmail.com>
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 7bit
X-ecartis-version: Ecartis v1.0.0
Sender: mint-bounce@lists.fishpool.fi
Errors-to: mint-bounce@lists.fishpool.fi
X-original-sender: joska@online.no
Precedence: bulk
List-help: <mailto:ecartis@lists.fishpool.fi?Subject=help>
List-unsubscribe: <mailto:mint-request@lists.fishpool.fi?Subject=unsubscribe>
List-Id: <mint.lists.fishpool.fi>
X-List-ID: <mint.lists.fishpool.fi>
List-subscribe: <mailto:mint-request@lists.fishpool.fi?Subject=subscribe>
List-owner: <mailto:tjhukkan@fishpool.fi>
List-post: <mailto:mint@lists.fishpool.fi>

Paul Wratt wrote:

> since toshyp has an html version online, but no other web
> infrastructure, or a mail list, then a way to edit at least the
> english version should at least be looked into
> 
> Other people have already discussed the issues surrounding wiki and
> cvs, specifically where documentation is concerned, and udo is
> technically capable of outputing and format it chooses (even wiki as
> xml)

I don't think a wiki is a good tool for maintaining programming docs.
This should be documented in the source and extracted with a tool like
Doxygen. Then it's much easier for the developers to update and add to
the docs as changes are made.

Jo Even