Re: Documentation

Subject: Re: Documentation
From: Dom Lachowicz (
Date: Tue Oct 24 2000 - 23:47:48 CDT

RMS et. al.,

I think that the help files should have a separate module in cvs as well as
(maybe all but english?) be downloaded separately from the Abiword binary.
And I'm all for some sort of generic PERL or M4 (or even C pre-processor :)
based automation system being used to generate these files. You could even
cheat and just have these templates on your own computer and submit to us
the result of running your Makefile and no one would know the difference.
Sounds like you need shtml-like features, so one of those two would be a
good choice for you. I prefer M4, but how you do it is up to you. Make your
life easier :-)


>Subject: Documentation
>Date: Wed, 25 Oct 2000 00:27:41 +0100
> I am going to RFC in this mailing list a new format for the
>documentation pages, which will, I hope, make life easy for translators.
> I decided to do this, since last time I tried to make the pt-PT help
>files I nearly got insane with the amount of repeated work.
> There will be, most definitely, a menu configuration. Something probably
>in the likes of:
> fileToLink.html localized text to use (that's a tab in between)
> I was considering using perl to generate the documentation.
> This because there are a few things in each documentation file that are
>VERY boring to do, and are the exact same in all pages. The header image
>and the menu, for example.
> What do you think?
> Yours, rms
>+ No matter how much you do, you never do enough -- unknown
>+ Whatever you do will be insignificant,
>| but it is very important that you do it -- Ghandi
>+ So let's do it...?
><< attach3 >>

Get Your Private, Free E-mail from MSN Hotmail at

Share information about yourself, create your own public profile at

This archive was generated by hypermail 2b25 : Tue Oct 24 2000 - 23:47:54 CDT