Documentation for LBInstDJ
==========================

Introduction
============

This program installs DJGPP v2.03 or later to your system. It features nice
user interface and simple usage.

Usage
=====

* Put all downloaded DJGPP packages (those .zip files) into one directory.

* Run install.exe. It is a SFX archive which will extract all required
installation files.

* One of those files is lbinstdj.exe. This is the actual installer. Run it.

* You will be presented with the introduction dialog. You may read it if
you care and press "Next" button to continue.

* If you are running Windows 95/98 you will be asked if you want to update
Windows registry to disable numeric tails like ~1, ~2,... in short versions
of long file names. This is *neccesary* if you want to use DJGPP in DOS box
and in plain DOS (See the DJGPP FAQ chapter 22.19 for details). This does
not apply do Windows NT - it does not support LFNs for DOS box anyway.
Answering "Yes" to this question will require reboot, so if you are going to
use DJGPP just in DOS box or just in plain DOS, you may answer "No" there.
If you do not see this dialog, it means that you have numeric tails already
disabled.

* You will be prompted to enter the DJGPP installation directory. The default
`c:/djgpp' is suggested so you may just press Enter here. If you do not like
default installation directory, you can enter it by hand or choose it from
directory browsing dialog box.

* Now you will have to enter the path to downloaded zips - DJGPP packages.

* All packages will be installed into specified directory. Depending on the
number of packages, it can take some time.

* If you have previously disabled numeric tails, you will be asked if you
want to reenable them again because disabled numeric tails may lead to data
loss in few obscure cases.

* Now you will be presented with autoexec.bat update dialog. At the left is
your current untouched autoexec.bat file and at the right is autoexec.bat file
with proposed updates. In most cases, it will be OK to accept new version,
however, if you have multiple configurations or call some shell from
autoexec.bat, you will have to adjust new version. When you're done, press
"Save changes" button if you want to have your current autoexec.bat to be
replaced with the new one. The old version will be saved as c:/autoexec.lbi.
If you are careful, you may press "Save as backup" - then your old
autoexec.bat will be left unaltered, and the new version will be saved as
c:/autoexec.bat.

* LBInstDJ quits, now you have to restart computer for changes in
autoexec.bat to take effect.

* Start using DJGPP  ;-)

Random things
=============

  Meaning of exit codes:
    0 - installation finished
    1 - reboot required
    2 - user canceled installation
    3 - error has occurred.

==========
I would appreciate any bug reports and suggestions about this program.
Send them to lauras@softhome.net

==========
This program uses Info-Zip's UnZip built with DJGPP. I did not include its 
source code due to its large size but it can be downloaded at 
http://www.cdrom.com/pub/infozip/ or ftp://ftp.cdrom.com/pub/infozip/

This program uses PMODE/DJ DPMI server.
It is copyright (C) 1994, by Tran AKA Thomas Pytel and copyright (C) 1996,
by Matthias Grimrath.

==========
Laurynas Biveinis
   lauras@softhome.net

