Brief guide to the PARI files.

In the main directory, you should have the following files:

-rw-rw-r--  1 pari          377 Mar  7 19:11 Buglist
-rw-rw-r--  1 pari         1203 Mar  7 19:12 Changes
-rw-rw-r--  1 pari        47458 Mar  4 12:43 Changes1.31-1.35
-rw-rw-r--  1 pari         9374 Mar  7 19:16 FILES
-rw-rw-r--  1 pari         5025 Mar  4 12:22 INSTALLATION
-rw-rw-r--  1 pari         2597 Mar  4 12:22 Makefile.port
-rw-rw-r--  1 pari         2985 Mar  4 12:22 Makefile.readline
-rw-rw-r--  1 pari         2945 Mar  4 12:22 Makefile.sun3
-rw-rw-r--  1 pari         3025 Mar  4 12:22 Makefile.sun4
-rw-rw-r--  1 pari         2531 Mar  4 12:22 README
-rw-rw-r--  1 pari        26923 Mar  5 11:59 alglin1.c
-rw-rw-r--  1 pari        26510 Mar  4 12:22 alglin2.c
-rw-rw-r--  1 pari        37079 Mar  5 11:56 anal.c
-rw-rw-r--  1 pari        40184 Mar  4 12:22 arith1.c
-rw-rw-r--  1 pari        29611 Mar  4 12:22 arith2.c
-rw-rw-r--  1 pari        19789 Mar  4 12:22 base.c
-rw-rw-r--  1 pari        36604 Mar  4 12:22 bibli1.c
-rw-rw-r--  1 pari        23115 Mar  4 12:22 bibli2.c
-rw-rw-r--  1 pari        50892 Mar  4 12:22 elliptic.c
-rw-rw-r--  1 pari         4527 Mar  4 12:22 erreurs.h
-rw-rw-r--  1 pari        34590 Mar  5 11:03 es.c
drwxrwxr-x  2 pari          512 Feb 12 16:54 example/
-rw-rw-r--  1 pari        47391 Mar  7 12:46 gen1.c
-rw-rw-r--  1 pari        51662 Mar  4 12:22 gen2.c
-rw-rw-r--  1 pari        44773 Mar  4 12:22 gen3.c
-rw-rw-r--  1 pari          914 Mar  4 12:22 gen68k.h
-rw-rw-r--  1 pari        20313 Mar  4 17:01 gencom.h
-rw-rw-r--  1 pari          310 Mar  4 12:22 genpari68k.h
-rw-rw-r--  1 pari          311 Mar  4 12:22 genpariother.h
-rw-rw-r--  1 pari         5070 Mar  4 12:22 genport.h
-rw-rw-r--  1 pari        15157 Mar  4 12:22 gp.c
-rw-rw-r--  1 pari        16056 Mar  4 12:22 gpreadline.c
-rw-rw-r--  1 pari         8178 Mar  4 12:22 init.c
-rw-rw-r--  1 pari        36268 Mar  4 17:00 messages.c
-rw-rw-rw-  1 pari       168180 Mar  4 12:22 mp.ami
-rw-rw-r--  1 pari        35547 Mar  4 12:22 mp.c
-rw-rw-rw-  1 pari       126347 Mar  4 12:22 mp.news
-rw-rw-rw-  1 pari       256274 Mar  4 12:28 mp.s
-rw-rw-r--  1 pari        17223 Mar  4 12:22 pari.el
-rw-rw-r--  1 pari        10867 Mar  7 19:10 pari.elc
-rw-rw-r--  1 pari         2355 Mar  4 12:22 pari.menu
-rw-rw-r--  1 pari         8381 Mar  4 12:22 pari.txt
-rw-rw-r--  1 pari         7917 Mar  4 12:22 plot.X
-rw-rw-r--  1 pari           88 Mar  4 12:22 plot.null
-rw-rw-r--  1 pari         6193 Mar  4 12:22 plot.sun
-rw-rw-r--  1 pari           88 Mar  4 12:22 plotdummy.c
-rw-rw-r--  1 pari        46722 Mar  7 18:40 polarit1.c
-rw-rw-r--  1 pari        32467 Mar  4 12:22 polarit2.c
-rw-rw-r--  1 pari         9975 Mar  4 12:22 sparc.s
-rw-rw-r--  1 pari         6561 Mar  7 18:54 testin
-rw-rw-r--  1 pari        32231 Mar  7 18:55 testout
drwxrwxr-x  2 pari          512 Feb 26 15:03 tex/
-rw-rw-r--  1 pari        33229 Mar  4 12:22 trans1.c
-rw-rw-r--  1 pari        44303 Mar  4 12:22 trans2.c
-rw-rw-r--  1 pari        25770 Mar  4 12:22 trans3.c
-rw-rw-r--  1 pari          951 Mar  5 12:14 version68k.c
-rw-rw-r--  1 pari         3971 Mar  5 12:14 versionport.c
-rw-rw-r--  1 pari          253 Mar  5 12:14 versionsparc.c

 
Buglist: contains a list of modifications to be made to PARI (in french).
Changes: contains a sometimes brief desciption of the list of changes since
        version 1.35 (in french).
Changes1.31-1.35: same, since version 1.31.
FILES: this file
INSTALLATION: detailed description of the installation procedure on Unix 
       systems. Same as appendix A of the manual.
Makefile.port: Makefile for the port version (no assembler at all).
Makefile.readline: Makefile if you want to use the GNU readline library. This
       Makefile is for Sun 3/X11 systems, but is easily changed for others.
Makefile.sun3: Makefile for the 68k version (more than 6000 lines of assembly
       code). Contrary to what its name may imply, it can be used on other
       680x0 machines with x>=2.
Makefile.sun4: Makefile for the sparc version (484 lines of assembly code).
README: General information about copyright, copying and spreading PARI, where
       to send bug reports.

alglin1.c, alglin2.c: linear algebra package.
anal.c: line-oriented syntactical analyser/parser.
arith1.c, arith2.c: number-theoretic package.
base.c: specialized package for algebraic number theory.
bibli1.c, bibli2.c: miscellaneous routines.
elliptic.c: specialized package for working with elliptic curves.
erreurs.h: include file containing pointers to error messages.
es.c: input-output routines.
gen1.c, gen2.c, gen3.c: second level kernel of PARI: deals with all the
       elementary operations between all the PARI types.
gen68k.h: specific include file for the 68k versions.
gencom.h: common include file to all versions.
genpari68k.h: file to be included in any program using PARI including PARI
       itself, for 68k versions. Includes gen68k.h.
genpariother.h: same but for non68k versions. Includes genport.h.
genport.h: specific include file for non68k versions.
gp.c: main program, including treatment of commands.
gpreadline.c: same as gp.c, with code added to support the GNU readline
       library. To be used in conjunction with Makefile.readline.
init.c: initialization procedures for PARI. The init() program must be called
       by any program using PARI (including gp) before doing any PARI 
       operations.
messages.c: contains first the short help messages for internal functions
       obtained by ?function, and second the text of all the error messages.
mp.ami: First level kernel of PARI, more than 6000 lines of MC68020 assembler,
       here using the Lattice syntax on the Amiga 2500 or above.
mp.c: In conjunction with versionport.c or sparc.s, first level kernel of
       PARI, written in C.
mp.news: same as mp.ami, using the Sony News assembler syntax.
mp.s: same as mp.ami, using the Sun 3 assembler syntax.
pari.el: emacs-lisp file contributed by David Carlisle which gives a much
       nicer user interface for GP in a GNUemacs buffer.
pari.elc: byte-compiled version of pari.el.
pari.menu: file used for the menu-driven help in the GP emacs buffer.
pari.txt: text explaining how to install and use pari.el and pari.menu.
plot.X: hires plot routines under the X11 window system. Note that this
       works on systems layered above X11 such as Sun's Openwindows or Motif.
plot.null: same when neither X11 nor sunview is available, so no hires plot
       is possible.
plot.sun: same as plot.X for the sunview/suntools window system.
plotdummy.c: same as plot.null, but used so as not to include the plotting 
       routines in the library libpari.a.
polarit1.c, polarit2.c: polynomial package.
sparc.s: level 0 kernel of PARI in 484 lines of Sparc assembly language,
       simulating the basic instructions on 32 and 64 bits.
testin: test suite for gp.
testout: what the result of gp<testin should be.
trans1.c, trans2.c, trans3.c: transcendental functions package.
version68k.c: level 0 kernel of PARI for the 68k version. Contains only the
       printversion() program and a program used for debugging.
versionport.c: level 0 kernel of PARI for the port (not 68k or sparc) version,
       entirely in C, simulating the basic instructions on 32 and 64 bits.
versionsparc.c: level 0 kernel of PARI for the sparc version, complementary
       to sparc.s. Contains only the printversion() program and the 2 line
       mulmodll() program.


In the tex subdirectory, you should have the following files corresponding
to the tex source for the user's manual:

-rw-r--r--  1 pari          390 Feb 20 14:42 Makefile
-rw-rw-r--  1 pari         5307 Mar  4 12:22 appa.tex
-rw-rw-r--  1 pari          686 Mar  4 12:22 appb.tex
-rw-rw-r--  1 pari         2090 Mar  4 12:22 appc.tex
-rw-rw-r--  1 pari         2155 Mar  4 12:22 appd.tex
-rw-rw-r--  1 pari         1324 Mar  4 12:22 index.tex
-rw-rw-r--  1 pari          353 Mar  4 12:22 titlepage.tex
-rw-rw-r--  1 pari         2196 Mar  4 12:22 users.tex
-rw-rw-r--  1 pari        16752 Mar  4 12:22 usersch1.tex
-rw-rw-r--  1 pari        21311 Mar  4 12:22 usersch2.tex
-rw-rw-r--  1 pari       112475 Mar  4 12:22 usersch3.tex
-rw-rw-r--  1 pari        50384 Mar  4 12:22 usersch4.tex

Makefile: for making the manual.
usersch1.tex: chapter 1, overview of the PARI system.
usersch2.tex: chapter 2, specific use of the GP calculator.
usersch3.tex: chapter 3, functions and operations available in PARI and GP.
usersch4.tex: chapter 4, programming PARI in library mode.
appa.tex: appendix A, installation guide for the UNIX versions.
appb.tex: appendix B, a sample Makefile.
appc.tex: appendix C, a complete program.
appd.tex: appendix D, summary of available constants.
titlepage.tex: cover page for the manual.
users.tex: TeX driver file for the manual.
index.tex: TeX driver file for the index (automatically generated by the
       Makefile).

In the example subdirectory, you should have the following files:

-rw-rw-r--  1 root          143 Feb 12 16:54 Makefile
-rw-rw-r--  1 root          112 Feb 12 16:54 Makesimple
-rw-rw-r--  1 root         1473 Feb 12 16:54 mattrans.c

Makefile: for the mattrans.c of chapter 4 and appendix C.
Makesimple: simple Makefile for gp itself.
mattrans.c: simple example program for computing the exponential of a matrix.
