
Bonjour !

You have ordered our bignum package: you are going to receive 3 messages
(one  would be too big for the mailer). These messages are named:
	BigNum - Part 1
	BigNum - Part 2
	BigNum - Part 3

These messages are shell archives built with the tool "makekit" based on
the tool "shar" (as SHell ARchiver).

To install the package bignum on your disk, create a directory where you want
install this package, and go there:
	mkdir bignum
        cd bignum

Copy the 3 messages from your  mail system to this directory.
For this example, we assume you have copied the messages in files bignum01,
bignum02, bignum03: use your favorite text editor to strip from each
of the 3 messages the header due to the mail system; each ends at
the line:
# Remove all text above and including this line. 

In the directory bignum, invoke the shell on these files:
	/bin/sh bignum01
	/bin/sh bignum02
	/bin/sh bignum03

The order in which to perform these 3 commands must be preserved.


After you are finished, the package is installed and your directory will
contain the following files:

   Documentation files:
      doc/bn.tex        - Document BigNum in LaTeX format
      doc/bnf.tex       - Document BigNum in French and LaTeX format

   C Include Files:
      h/BigZ.h		- Types and structures for clients of BigZ
      h/BigNum.h	- Types and structures for clients of BigNum

   C Source Code:
      c/bz.c		- BigZ implementation
      c/bn.c		- BigNum implementation ("non-kernel" routines)
      c/KerN.c		- BigNum implementation ("kernel" routines)
      c/bzf.c		- Miscellaneous functions built on top of BigZ
      c/bztest.c	- Test program for verifying a BigNum implementation
      c/testKerN.c	- Test program for verifying KerN implementation

   Assembly-Language Source Code:
      s/vaxKerN.s	- Vax implementation of KerN
      s/68KerN.s	- 68020 implementation of KerN (MIT syntax)
      s/68KerN.mot.s	- 68020 implementation of KerN (Motorola syntax)
      s/nsKerN.s	- NS implementation of KerN

   Other Files:
      Makefile		- Compiles source code, creates test program


Now, to build or modify the current version of the package, type one of:
        make vax	- to use vax assembly code
	make 68K	- to use 68020 assembly code
	make ns		- to use NS assembly code
	make C16	- to use C code with 16 bits digits
        make C32        - to use C code with 32 bits digits (default version)

Each of these commands products the following files:
        BigNum.a        - BigNum library
        testKerN        - Test program executable for KerN
        bztest          - Test program executable for BigZ

When you have built a version of the package bignum, you can test it
by invoking the test programs:
	testKerN all    - Tests the functions in the kernel
	bztest          - Tests the generic functions at the Z level

If you have the tools LaTeX (L. Lamport's special version of Knuth's
famous TeX, as described in the Addison-Wesley book), makeindex and
aptex, type: 
	make doc        - to build the Postscript files of the documents, 

If you do not have aptex, use your local equivalent tool to print
the dvi file produced by the latex command. 


We hope all is well !
Please, let us know if you have had some problems. 
All reported bugs will be corrected. All improvements to the package
which you send back to us will be included in the successive releases,
with an author's acknowledgement.

     Merci! and have fun ...

This package was initially developped at INRIA by J. Vuillemin. The
following people have greatly contributed to bring it to it's present
state: Patrice Bertin, Hans Boehm, Jerome Chailloux, Michel Gangnet, 
Jean Claude Herve, Francois Morain, David Salesin, Mark Shand, 
Bernard Serpette, Jean Vuillemin. 

    distribution: 
        librarian@decprl.dec.com

    installation, use, suggestions:
        herve@decprl.dec.com
        serpette@inria.inria.fr
