Date: Wed, 12 Nov 1997 14:15:18 +0200 (IST)
From: Eli Zaretskii <eliz AT is DOT elta DOT co DOT il>
To: Jim Chapman <jim DOT chapman AT sympatico DOT ca>
cc: djgpp AT delorie DOT com
Subject: Re: documentation
In-Reply-To: <34694473.3123@sympatico.ca>
Message-ID: <Pine.SUN.3.91.971112141501.20379S-100000@is>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Precedence: bulk


On Tue, 11 Nov 1997, Jim Chapman wrote:

> I am starting a project to document a number of application systems
> consisting of about 500 programs. They do not run on PC's. I would very
> much prefer to use DJGPP tools such as emacs and make to do this. Does
> anyone have any advice concerning the text formatter. Most of the users
> only know things like MS Word so I would have to give them the
> documentation in a form they could update with that. I am familiar with
> nroff but not with tex. Any advice would be appreciated.

I suggest writing the docs in Texinfo, the GNU documentation format
(Emacs has a special editing mode for it).  It can be converted to
Info (for on-line browsing) and to TeX for producing beautiful printed
docs.

The Word thing is more difficult.  I'm not sure I understand why do
you need to support Word format if the programs will run in an
environment other than a PC.  Can you explain?

Anyway, converters are available from Texinfo to HTML and PDF, if it
will help those Word types.

All of the above are available as DJGP ports as well.