Installation procedure for info.ttp
===================================

Copy a program into one of directories on your PATH, or where you
normally keep 'clickable' programs.

Create directories where you going to keep info files and set
environment variable INFOPATH where all these directories are listed.
You may use slashes or backslashes as directory separators.
The program is compiled with ".,c:/gnu/info,a:/" as INFOPATH default
value and this will be used if you will not tell otherwise.

Put supplied files 'dir' and 'info' in one of directories on INFOPATH.

If you would like to use termcap terminal description provide 
environment variables TERM with a name of a terminal entry your are
going to use and TERMCAP which keeps a full path name of a termcap
file - like "c:\etc\termcap" for example.  If termcap is not given
info.ttp will use a default termcap description with a number of rows
and columns set to a full height and width, hopefully, of your screen.
Info needs, in order to run, a set of termcap capabilities similar to
those required by emacs (the same termcap of course can be used)
so be sure that they are listed.  A sample termcap file is provided.
Modify as needed.  Info.ttp is not spooked by a presence of CR's in
a termcap file but can live without them as well.

Start info and if everything is OK you should be greeted by a top
menu screen of info.  Follow screen instructions and have a ball.
When you are done read manual page.

Troubleshooting
===============

In case of problems check if you really have 'dir' and 'info' files
and they reside in one of directories listed in INFOPATH.  Check if
INFOPATH does not have embedded spaces and proper path separators
are used (comma or colon if you are using MiNT or you have set
UNIXMODE with 'd' flag in it, comma or semicolon otherwise).
Check if you can start info by a command like 'info -f' followed
by a full path to 'dir' file.  If this failed check if your computer
is plugged in. :-)

Adding new files to info top menu
=================================

To have your documention files listed automatically by info add them
to menu in dir file.  As distributed it comes with only these lines
in it:

* Menu: The list of major topics begins on the next line.

* Info: (info).      Documentation browsing system.

Just add more such lines with any text editor but keep the same format
- star followed by title, which ends with colon, and followed by info
file name in parentheses and full stop.  File suffix, if '.inf', does
not have to be listed.  Remainder of a line contains just description.
So, for example, if you are adding file 'gulam.inf' you should edit
your menu into something like this:

* Menu: The list of major topics begins on the next line.

* Info: (info).          Documentation browsing system.

* Gulam shell: (gulam).  My favourite shell - docs.

And so on.  If you are adding big manuals which were split by makeinfo
then only top '.inf' file has to be listed in this menu.  For files
meant for an on-line viewing you should not try to prevent splitting.
Info loads every file it shows entirely into memory, so it is better
not to have them to big if you still have some other memory uses.
System of tags will allow for fast browsing anyway.

   Michal Jaegermann
   ntomczak@vm.ucs.ualberta.ca