Date: Sun, 23 Aug 1998 18:11:28 +0300 (IDT)
From: Eli Zaretskii <eliz AT is DOT elta DOT co DOT il>
To: Poppleton <Alan DOT Poppleton AT wanadoo DOT fr>
cc: djgpp AT delorie DOT com
Subject: Re: personalised help
In-Reply-To: <35DFFC83.123BB204@Wanadoo.fr>
Message-ID: <Pine.SUN.3.91.980823180513.1451x-100000@is>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Precedence: bulk


On Sun, 23 Aug 1998, Poppleton wrote:

> I am writing a library, and I was just wandering if it would be possible
> to write a help file like the one that comes with the djgpp package,
> such that when you click on the right-button in rhide, it displays the
> help for that command.  I have already succesfully tried editing the
> libc.inf file, but it is not only very time consuming to do it that way,

You create an Info file by writing its source in a special markup 
language called Texinfo.  The documentation of Texinfo comes with the 
txxi312b.zip package, which you already should have installed.  Type 
"info texinfo" from the DOS prompt and read there.  The docs include a 
tutorial and a reference for all the markup tags.

To create the Texinfo sources, it helps to use an editor which has 
built-in support for Texinfo.  One such editor is Emacs (a port is 
available from the v2gnu directory on DJGPP sites).  It will highlight 
the Texinfo source and has several handy key bindings that make writing 
Texinfo source much easier.  I used it to write the entire DJGPP FAQ in 
Texinfo.

Once you have the Texinfo source, you generate an Info file from it by 
running the makeinfo.exe program (which also comes wiuth txi312b.zip).