On 11-Jul-2001 Altair wrote:
> Hi all, especially Davide!
>
> Today I was doing some black magic with my XMail and it requires lot of
> documentation reading. I think so one long TXT file is not very good format
> for documentation of such size. I think so set of linked HTML files would be
> better and more readable, due possibility of formatting. (Current manual in
> HTML format as can be seen at xmail web site is practically only <pre>
> surrounded text version). What do you think?
>
> I can convert current documentation to HTML files and format it, but it needs
> to be updated (I don't want to convert it every new version). Davide, what do
> you think about it?
>
> HTML documentation can replace current TXT and you can maintain it, or are
> you capable to send me list of changes when main doc changes?
This must be my luky week coz I've two guys that would like to work on the
( pretty shitty ) documentation.
Richard Mayhew <[EMAIL PROTECTED]> is starting writing a new manual for
XMail that we agree to be written has manual pages.
This is an open discussion and I would like to know users opinions too.
I like a format that can be read with a standard text editor ( lets get vi as
example ) and that can be easy maintained by a guy ( me ) that don't like to
use html editors.
What would be perfect is to have a format that can be easily translated into
other formats.
The documentation anyway, does not need only a format changed but also a
content change.
- Davide
