Brief guide to the PARI files.

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

-rw-rw-r--  1 pari          955 Dec 31 18:00 Buglist
-rw-rw-r--  1 pari          486 Jan 19 15:51 Changes
-rw-rw-r--  1 pari        47459 Jul 18  1993 Changes1.31-1.35
-rw-rw-r--  1 pari        41438 Sep 18  1993 Changes1.35-1.38
-rw-rw-r--  1 pari        24335 Jan 16 12:44 Changes1.38-1.39
-rw-rw-r--  1 pari        14989 Jan 19 17:14 FILES
-rw-rw-r--  1 pari        10871 Dec 31 21:53 INSTALL
-rw-rw-r--  1 pari         1007 Oct  1  1993 INSTALL.DOS
-rw-rw-r--  1 pari         4107 Aug  1 17:34 KERNELSPECS
-rw-rw-r--  1 pari         4470 Dec  5  1993 Makefile.DOS
-rwxrwxr-x  1 pari         8847 Dec 31 21:29 Makemakefile*
-rw-rw-r--  1 pari        10749 Jul 18  1993 Newin1.37
-rw-rw-r--  1 pari         7479 Sep  7  1993 Newin1.38
-rw-rw-r--  1 pari        11348 Jan  7 18:24 Newin1.39
-rw-rw-r--  1 pari         3793 Dec 14 21:36 PPC.s
-rw-rw-r--  1 pari         3078 Dec 22 11:26 README
-rw-rw-r--  1 pari          572 Dec 31 18:03 THANKS
-rw-rw-r--  1 pari          411 Dec 13 00:37 TODO
-rw-rw-r--  1 pari        53232 Jan 12 13:19 alglin1.c
-rw-rw-r--  1 pari        35977 Dec 11 15:57 alglin2.c
-rw-rw-r--  1 pari         4816 Nov 20 16:40 alpha.s
-rw-rw-r--  1 pari        53834 Jan 11 21:14 anal.c
-rw-rw-r--  1 pari        53234 Jan 10 19:10 arith1.c
-rw-rw-r--  1 pari        35628 Dec 31 13:28 arith2.c
-rw-rw-r--  1 pari        72860 Jan 13 00:11 base1.c
-rw-rw-r--  1 pari        68395 Jan 19 15:45 base2.c
-rw-rw-r--  1 pari       101020 Jan 18 16:48 base3.c
-rw-rw-r--  1 pari        88437 Jan 11 15:55 bibli1.c
-rw-rw-r--  1 pari        60890 Dec 31 13:21 bibli2.c
-rw-rw-r--  1 pari        56331 Jan  2 14:51 buch1.c
-rw-rw-r--  1 pari        74583 Jan 13 17:33 buch2.c
-rw-rw-r--  1 pari          274 May 29  1994 dummy.c
-rw-rw-r--  1 pari        61493 Dec 30 17:04 elliptic.c
-rw-rw-r--  1 pari         5787 Jan 11 15:50 erreurs.h
-rw-rw-r--  1 pari        20320 Jan 11 15:51 errmessages.c
-rw-rw-r--  1 pari        42073 Jan 16 12:36 es.c
-rw-rw-r--  1 pari        48300 Jan 12 15:05 gen1.c
-rw-rw-r--  1 pari        56481 Dec 31 15:47 gen2.c
-rw-rw-r--  1 pari        58852 Dec 31 15:39 gen3.c
-rw-rw-r--  1 pari         5108 May 22  1994 gen68k.h
-rw-rw-r--  1 pari         1467 Nov 28  1993 gen68kplus.h
-rw-rw-r--  1 pari        43554 Jan 19 15:49 gencom.h
-rw-rw-r--  1 pari          466 Dec  2 10:27 genpari68k.h
-rw-rw-r--  1 pari          824 Dec 14 21:36 genparimac.h
-rw-rw-r--  1 pari          373 Dec  2 10:28 genpariother.h
-rw-rw-r--  1 pari         3675 Jun 19  1994 genport.h
-rw-rw-r--  1 pari          942 Jul 18  1993 gp.1
-rw-rw-r--  1 pari        16462 Jan 16 12:06 gp.c
-rw-rw-r--  1 pari         1394 Dec  8  1993 gp.man
-rw-rw-r--  1 pari         6174 Jan 12 11:27 gp_rl.c
-rw-rw-r--  1 pari          993 Nov 24 21:25 gphelp
-rw-rw-r--  1 pari        18608 Jan 16 12:06 gpreadline.c
-rw-rw-r--  1 pari        46880 Jan 11 21:15 helpmessages.c
-rw-rw-r--  1 pari         3635 Aug  4  1993 hppa.s
-rw-rw-r--  1 pari         6978 Dec  8  1993 i386.c
-rw-rw-r--  1 pari        15362 Jan 16 11:58 init.c
-rw-rw-r--  1 pari       163869 Dec 12 15:25 mp.ami
-rw-rw-r--  1 pari        39338 Jan 19 15:45 mp.c
-rw-rw-r--  1 pari       124552 Dec 12 15:14 mp.news
-rw-rw-r--  1 pari       249687 Dec 12 15:21 mp.s
-rw-rw-r--  1 pari         2419 Dec 18  1993 mpansi.h
-rw-rw-r--  1 pari         1515 Jun 14  1994 mpdefs.h
-rw-rw-r--  1 pari        29976 Jan 19 17:04 mpin.c
-rw-rw-r--  1 pari        12564 Jan  8 12:26 mpin.h
-rw-rw-r--  1 pari        25728 Dec 10 13:40 pari.el
-rw-rw-r--  1 pari        20582 Jul 18  1993 pari.el-changes
-rw-rw-r--  1 pari        16604 Jul 18  1993 pari.elc
-rw-rw-r--  1 pari         4444 Jan 13 00:36 pari.menu
-rw-rw-r--  1 pari         9737 Jul 18  1993 pari.txt
-rw-rw-r--  1 pari        15944 May 29  1994 plotX.c
-rw-rw-r--  1 pari          274 May 29  1994 plotnull.c
-rw-rw-r--  1 pari        12482 May 29  1994 plotsun.c
-rw-rw-r--  1 pari        80686 Jan 10 16:30 polarit1.c
-rw-rw-r--  1 pari        55239 Jan  6 23:32 polarit2.c
-rw-rw-r--  1 pari         9975 Aug  4  1993 sparcv7.s
lrwxrwxrwx  1 pari           14 Jan 16 11:08 sparcv8.s -> sparcv8super.s
-rw-rw-r--  1 pari         3200 May 28  1994 sparcv8micro.s
-rw-rw-r--  1 pari         7452 May 28  1994 sparcv8super.s
-rw-rw-r--  1 pari        13016 Jan 13 22:28 testin
-rw-rw-r--  1 pari        83462 Jan 16 12:41 testout
-rw-rw-r--  1 pari        83333 Jan 16 12:44 testout64
-rw-rw-r--  1 pari          742 Jul 19  1994 testplotin
-rw-rw-r--  1 pari        34000 Oct 28 18:52 trans1.c
-rw-rw-r--  1 pari        41594 Dec 31 16:22 trans2.c
-rw-rw-r--  1 pari        31599 Dec 11 16:36 trans3.c
-rw-rw-r--  1 pari          658 Dec  2 09:44 version386.c
-rw-rw-r--  1 pari         5604 Jan 19 15:45 version68k.c
-rw-rw-r--  1 pari          825 Dec 14 21:36 versionPPC601.c
-rw-rw-r--  1 pari          897 Dec 12 16:00 versionalpha.c
-rw-rw-r--  1 pari          674 Jan 16 15:16 versionhp.c
-rw-rw-r--  1 pari         5453 Dec 31 21:42 versionport.c
-rw-rw-r--  1 pari         1373 Dec  2 10:37 versionsparcv7.c
-rw-rw-r--  1 pari         1368 Dec  2 10:36 versionsparcv8.c

Buglist: contains a list of modifications to be made to PARI (in french).
Changes: contains a brief description of the list of changes since 
       version 1.39 (in french).
Changes1.31-1.35: same, from version 1.31 to 1.35.
Changes1.35-1.38: same, from version 1.35 to 1.38.
Changes1.38-1.39: same, from version 1.38 to 1.39.
FILES: this file.
INSTALL: detailed description of the installation procedure on Unix 
       systems. Similar to appendix A of the manual.
INSTALL.DOS: same for DOS based systems.
KERNELSPECS: A detailed description of the specifications of the level 0
       kernel routines which should be written in assembler. Similar to
       the beginning of chapter 5 of the manual.
Makemakefile: script written by B. Haible which automatically generates
       the Makefile. See the file INSTALL for details.
Newin1.37: New features of version 1.37 compared to version 1.35 (must
       be read by users of versions 1.35, and also by users of version
       1.36).
Newin1.38: New features since version 1.37.
Newin1.39: New features since version 1.38.
README: General information about copyright, copying and spreading PARI, where
       to send bug reports.
THANKS: Acknowledgements for Version 1.39.
TODO: maybe in a few years!

alglin1.c, alglin2.c: linear algebra package.
alpha.s: level 0 kernel of PARI in 296 lines of DEC alpha assembly language,
       simulating the basic instructions on 64 and 128 bits.
anal.c: line-oriented syntactical analyser/parser.
arith1.c, arith2.c: number-theoretic package.
base1.c, base2.c, base3.c: package for algebraic number theory.
bibli1.c, bibli2.c: miscellaneous routines.
buch1.c, buch2.c: specialized package for sub-exponential class group,
       regulator and fundamental units algorithms (McCurley, Buchmann).
dummy.c: contains dummy declarations of the functions which are not going
       to be part of the library libpari.a, for example the plotting
       routines.
elliptic.c: specialized package for working with elliptic curves.
erreurs.h: include file containing pointers to error messages.
errmessages.c: all 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 as genpari68k.h but for non68k versions. Includes 
       genport.h.
genport.h: specific include file for non68k versions.
gp.1: primitive man page for GP, kindly written for us by B. Haible.
gp.c: main program, including treatment of commands.
gp_rl.c: auxiliary program to be used with gpreadline.c for the GNU readline
       library.
gphelp: perl script for help in Pari. Not yet supported.
gpreadline.c: same as gp.c, with code added to support the GNU readline
       library. 
helpmessages.c: short help messages for the internal functions obtained by
       ?function.
hppa.s: level 0 kernel of PARI in 230 lines of HP-PA assembly language,
       simulating the basic instructions on 32 and 64 bits.
init.c: initialization procedures for PARI. The init() program must be called
       by any program using PARI (including gp) before doing any PARI 
       operations.
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.
mpansi.h: include file for the ANSI C environment.
mpdefs.h: common include file, #defining code fields of objects.
mpin.c: Same as mp.c, but for use in a C++ environment (see INSTALL file).
mpin.h: include file for the C++ environment.
pari.el: emacs-lisp file contributed by David Carlisle which gives a much
       nicer user interface for GP in a GNUemacs buffer. Version 2.13.
pari.el-changes: change file for pari.el.
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.
plotX.c: hires plot routines under the X11 window system. Note that this
       works on systems layered above X11 such as Sun's Openwindows or Motif.
plotnull.c: same when neither X11 nor sunview is available, so no hires plot
       is possible.
plotsun.c: same as plotX.c for the sunview/suntools window system.
polarit1.c, polarit2.c: polynomial package.
sparcv7.s: level 0 kernel of PARI in 484 lines of Sparc assembly language,
       simulating the basic instructions on 32 and 64 bits.
sparcv8.s: symbolic link to either sparcv8super.s or sparcv8micro.s.
sparcv8super.s: level 0 kernel of PARI in 399 lines of Sparc version 8 assembly
       language, simulating the basic instructions on 32 and 64 bits. Faster
       than sparcv7.s even on a version 8 machine since it uses hardwired
       multiply/divide. Optimized for the Supersparc architecture, for which
       the full version 8 is not implemented.
sparcv8micro.s: level 0 kernel of PARI in 115 lines of Sparc version 8 assembly
       language, simulating the basic instructions on 32 and 64 bits. Faster
       than sparcv7.s even on a version 8 machine since it uses hardwired
       multiply/divide. Optimal when the full version 8 is implemented (e.g.
       Microsparc).
testin: test suite for gp.
testout: what the result of gp<testin>& should be on 32-bit machines.
testout64: what the result of gp<testin>& should be on 64-bit machines (at
       least on the DEC alpha).
testplotin: test suite for the plotting and postscript functions of gp.
trans1.c, trans2.c, trans3.c: transcendental functions package.
version68k.c: level 0 kernel of PARI for the 68k version, complementary
       to mp.s.
versionalpha.c: level 0 kernel of PARI for the DEC alpha version,
       complementary to alpha.s.
versionhp.c: level 0 kernel of PARI for the sparc version, complementary
       to hppa.s.
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.
versionsparcv7.c: level 0 kernel of PARI for the sparc version, complementary
       to sparcv7.s. 
versionsparcv8.c: level 0 kernel of PARI for the sparc version, complementary
       to sparcv8.s. 

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

-rw-r--r--  1 pari          494 Dec 14 21:33 Makefile
-rw-r--r--  1 pari        11733 Jan  7 22:48 appa.tex
-rw-r--r--  1 pari          723 Aug  6 14:00 appb.tex
-rw-r--r--  1 pari         2090 Feb  7  1993 appc.tex
-rw-r--r--  1 pari         2171 Aug  6 12:41 appd.tex
-rw-r--r--  1 pari          604 Jan 14 22:37 titlepage.tex
-rw-r--r--  1 pari       110324 Jan 15 00:28 tutorial.tex
-rw-r--r--  1 pari         4320 Jan 13 00:40 users.tex
-rw-r--r--  1 pari        18691 Jan 14 22:38 usersch1.tex
-rw-r--r--  1 pari        25987 Jan 14 22:55 usersch2.tex
-rw-r--r--  1 pari       231424 Jan 14 23:50 usersch3.tex
-rw-r--r--  1 pari        61264 Jan 15 00:01 usersch4.tex
-rw-r--r--  1 pari        33095 Nov 13 01:40 usersch5.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.
usersch5.tex: chapter 5, technical reference guide for low level functions.
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.
tutorial.tex: a GP tutorial (not completed).
users.tex: TeX driver file for the manual.

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

-rw-r--r--  1 pari         3319 Nov  2  1993 EXPLAIN
-rw-r--r--  1 pari          182 Oct 26 23:41 Makefile
-rw-r--r--  1 pari          151 Nov  5  1993 Makesimple
-rw-r--r--  1 pari          100 Aug  5  1993 bench.gp
-rw-r--r--  1 pari         2169 Nov  2  1993 clareg.gp
-rw-r--r--  1 pari           52 Aug  5  1993 lucas.gp
-rw-r--r--  1 pari         1520 Aug  5 16:00 mattrans.c
-rw-r--r--  1 pari          260 Aug  5  1993 rho.gp
-rw-r--r--  1 pari          709 Feb  7  1993 squfof.gp
-rw-r--r--  1 pari         1830 Jan 12 21:29 tutnf.gp
-rw-r--r--  1 pari         8017 Jan 12 21:31 tutnfout

EXPLAIN: explanations for the GP programs in this directory.
Makefile: for the mattrans.c of chapter 4 and appendix C.
Makesimple: simple Makefile for gp itself.
bench.gp: a fibonacci benchmark. Try it on Mma or Maple!
clareg.gp: a complete GP program for computing class groups and units in 
      general number fields, to be read under GP with the command \r clareg.gp.
      Totally superseded by the Pari program buchgen, but still a nice
      example of sophisticated GP programming.
lucas.gp: the Lucas-Lehmer primality test for Mersenne numbers.     
mattrans.c: simple example C program using the PARI library for computing the
      exponential of a matrix.
rho.gp: The Pollard rho method of factoring.
squfof.gp: a complete GP program for Shanks's SQUFOF factoring method, to be
      read under GP with the command \r squfof.gp.
tutnf.gp: sequence of GP commands used in the general number field section of
      the tutorial.
tutnfout: slightly edited output of tutnf.gp
