Re: [MiNT] FreeMiNT documentation

["Konrad Kokoszkiewicz" <draco@obta.uw.edu.pl>]

> Draco: I didn't wanted to write new docs from scratch (I know this is
> a veery booring job), my idea is to use existing docs and form the
> new, slightly modified and restruturized docs from it.

Good to hear :-)

> As for destination format, it should be wordly and easy readable. So,
> lets point few possibilities:
>
> 1) info - mostly used in unix world. Not easy readable anywhere else.
> I do not think it is a good option.
> 2) man - the same problems as info (remember - not every FreeMiNT
> user, or even software developer that uses FreeMiNT wants a full
> blown unix setup) 3) pdf - we do not have good enough viewer on our
> platform :( 4) hyp - this could be good and nice, but there are no
> viewers for it outside our world (or am I wrong?)
> 5) html - that is a best option in my opinion.Widely used, wery well
> dosumented, lots of tools avialible, we have good browser (Highwire),
> and most of all - every platform has a browser, so it would be easy
> readable everywhere.

Why not to use the GOSH? Source files are plain text, so that there should
be no problem reading them even under plain TOS, and updates are easy too.
Finally, all this can be easily converted to HTML, which we could put to the
web etc. Both formats are readable anywhere.

--
CVV
Konrad M.Kokoszkiewicz, http://draco.atari.org

** Ea natura multitudinis est,
** aut seruit humiliter, aut superbe dominatur.
** Taka to już natura pospólstwa, albo służalczo się płaszczy,
** albo bezczelnie się panoszy. (Liwiusz XXIV, 25).