--------------------------------------------------------------------------
Subject: Readme file for large-integer arithmetic Basic library
Date   : 02-02-2004
Code   : QuickBASIC 4.5, PDS 7.1, VBdos 1.0
--------------------------------------------------------------------------

To install this package
1) Open batchfile "largeint.bat" and adjust the path to the QuickBasic
   interpreter.
2) Set the working directory with a "SET LARGEINT=some\directory"
   statement in "autoexec.bat" or use the "msconfig.exe" utility.
   If LARGEINT isn't in the environment, the current directory is used.
3) Finally run "copypack.bat" to copy all files to the proper locations.

Note:

 This doesn't apply to the FreeBasic version yet. FB installation
 instructions are included in directory ".\library\freebasic".


Usage of these big number modules is mostly self-explanatory, as they
prompt for the exact kind of input they expect. Zero input aborts
execution, in running programs use Ctrl-Break or Ctrl-c.

Instead of typing long sequences of digits at the prompt, preferably
redirect from input datafiles using batch programs. All results are
saved to disk, so data is quickly transferred by copying & pasting from
output to inputfiles. "copypack.bat" copies a bunch of sample templates
and batchfiles to the working directory.

Thus, each module is started from the working directory with a batchfile
of the same name. If an inputfile of the same name is also present, then
its data is redirected to the module. (All inputfiles are textfiles with
no extension.) To allow immediate input, simply rename or remove the
inputfile.

First of all, run "primflgs.bas". This module generates a compact,
encoded list of prime numbers below 2,900,000 used by library
function Nxtprm().

Before using the encoder / decoder set, create your own keys with
"genrator.bas", which writes all data necessary for modular
exponentiation to "public.key" and "private.key".

If you want to start coding with the library, you'll find do's & don'ts
and a short description of the task each routine is able to perform in
headerfile "largeint.bi".

When you recieve an "Out of environment space" message if you start
these batchfiles under Windows, find "system.ini" in your windir and
edit as follows: under the header [NonWindowsApp]
                 add the line     CommandEnvSize=1024
Reboot your computer for the change to take effect.

Good luck!