Brief guide to the PARI files.

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

-rw-rw-r--  1 pari         1502 Jul 18 21:24 Buglist
-rw-rw-r--  1 pari        17635 Sep 10 17:53 Changes
-rw-rw-r--  1 pari        47459 Jul 18 21:24 Changes1.31-1.35
-rw-rw-r--  1 pari        24033 Jul 18 21:24 Changes1.35-1.37
-rw-rw-r--  1 pari        13105 Sep 22 15:15 FILES
-rw-rw-r--  1 pari        10360 Sep 10 17:39 INSTALL
-rwxr-xr-x  1 pari         8174 Sep  3 21:13 Makemakefile*
-rw-rw-r--  1 pari        10749 Jul 18 21:24 Newin1.37
-rw-rw-r--  1 pari         7479 Sep  7 01:00 Newin1.38
-rw-rw-r--  1 pari         3030 Jul 24 20:47 README
-rw-rw-r--  1 pari          630 Jul 24 20:44 TODO
-rw-rw-r--  1 pari        49704 Sep  9 17:12 alglin1.c
-rw-rw-r--  1 pari        36136 Sep  6 01:04 alglin2.c
-rw-rw-r--  1 pari        48483 Sep  6 13:57 anal.c
-rw-rw-r--  1 pari        49164 Sep  8 15:41 arith1.c
-rw-rw-r--  1 pari        35369 Aug 25 16:47 arith2.c
-rw-rw-r--  1 pari        47991 Sep  4 00:45 base1.c
-rw-rw-r--  1 pari        60059 Sep  9 12:52 base2.c
-rw-rw-r--  1 pari        70429 Sep 14 16:58 bibli1.c
-rw-rw-r--  1 pari        51129 Aug 25 16:27 bibli2.c
-rw-rw-r--  1 pari        87346 Sep 10 17:33 buch.c
-rw-rw-r--  1 pari         1013 Sep 22 15:12 dummy.c
-rw-rw-r--  1 pari        63972 Aug 25 16:28 elliptic.c
-rw-rw-r--  1 pari         5573 Aug  4 23:53 erreurs.h
-rw-rw-r--  1 pari        20211 Sep  6 13:56 errmessages.c
-rw-rw-r--  1 pari        39584 Sep  8 17:11 es.c
-rw-rw-r--  1 pari        48073 Aug 10 13:30 gen1.c
-rw-rw-r--  1 pari        55542 Sep 14 16:53 gen2.c
-rw-rw-r--  1 pari        54213 Aug 25 16:30 gen3.c
-rw-rw-r--  1 pari         5040 Aug 25 16:30 gen68k.h
-rw-rw-r--  1 pari        37217 Sep  8 11:53 gencom.h
-rw-rw-r--  1 pari          410 Aug  4 23:53 genpari68k.h
-rw-rw-r--  1 pari          462 Aug  4 23:53 genpariother.h
-rw-r-----  1 pari         5143 Aug 26 13:53 genport.h
-rw-r--r--  1 pari          942 Jul 18 21:24 gp.1
-rw-rw-r--  1 pari        15592 Aug 25 16:31 gp.c
-rw-rw-r--  1 pari        18442 Aug 25 16:31 gpreadline.c
-rw-rw-r--  1 pari        35320 Sep  6 13:57 helpmessages.c
-rw-rw-r--  1 pari         3635 Aug  4 23:53 hppa.s
-rw-rw-r--  1 pari        12615 Sep  8 11:16 init.c
-rw-rw-r--  1 pari       168085 Feb  3  1993 mp.ami
-rw-rw-r--  1 pari        37999 Aug 26 13:58 mp.c
-rw-rw-r--  1 pari       126291 Aug  4 23:53 mp.news
-rw-rw-r--  1 pari       256138 May 24 17:10 mp.s
-rw-rw-r--  1 pari         2406 Aug 25 16:33 mpansi.h
-rw-rw-r--  1 pari        29627 Aug 26 13:58 mpin.c
-rw-rw-r--  1 pari         9557 Aug 26 13:59 mpin.h
-rw-r--r--  1 pari        25732 Jul 18 21:24 pari.el
-rw-r--r--  1 pari        20582 Jul 18 21:24 pari.el-changes
-rw-rw-r--  1 pari        16604 Jul 18 21:24 pari.elc
-rw-rw-r--  1 pari         3656 Sep  6 13:55 pari.menu
-rw-r--r--  1 pari         9737 Jul 18 21:24 pari.txt
-rw-rw-r--  1 pari        16142 Aug 25 16:34 plotX.c
-rw-rw-r--  1 pari          274 Aug 25 16:34 plotnull.c
-rw-rw-r--  1 pari        12724 Aug  4 23:53 plotsun.c
-rw-rw-r--  1 pari        72409 Aug 25 16:36 polarit1.c
-rw-rw-r--  1 pari        43038 Aug 25 16:37 polarit2.c
-rw-rw-r--  1 pari         9975 Aug  4 23:53 sparcv7.s
lrwxrwxrwx  1 pari           14 Sep 22 15:12 sparcv8.s -> sparcv8super.s
-rw-rw-r--  1 pari         2837 Jul 24 21:05 sparcv8micro.s
-rw-rw-r--  1 pari         7253 Jul 18 21:24 sparcv8super.s
-rw-rw-r--  1 pari        10815 Sep  8 15:50 testin
-rw-rw-r--  1 pari        59680 Sep 10 17:57 testout
-rw-rw-r--  1 pari          739 Jul 18 21:24 testplotin
-rw-rw-r--  1 pari        33976 Sep 14 16:45 trans1.c
-rw-rw-r--  1 pari        44775 Aug 26 14:02 trans2.c
-rw-rw-r--  1 pari        32652 Sep  8 15:57 trans3.c
-rw-rw-r--  1 pari         5100 Sep 10 17:36 version68k.c
-rw-rw-r--  1 pari          370 Sep 10 17:36 versionhp.c
-rw-rw-r--  1 pari         3984 Sep 10 17:36 versionport.c
-rw-rw-r--  1 pari          374 Sep 10 17:36 versionsparcv7.c
-rw-rw-r--  1 pari          374 Sep 10 17:35 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.37 (in french).
Changes1.31-1.35: same, from version 1.31 to 1.35.
Changes1.35-1.37: same, from version 1.35 to 1.37.
FILES: this file
INSTALL: detailed description of the installation procedure on Unix 
       systems. Similar to appendix A 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.
README: General information about copyright, copying and spreading PARI, where
       to send bug reports.
TODO: maybe in a few years!

alglin1.c, alglin2.c: linear algebra package.
anal.c: line-oriented syntactical analyser/parser.
arith1.c, arith2.c: number-theoretic package.
base1.c, base2.c: package for algebraic number theory.
bibli1.c, bibli2.c: miscellaneous routines.
buch.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 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.
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.
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.
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. Contains only the
       printversion() program and a program used for debugging.
versionhp.c: level 0 kernel of PARI for the sparc version, complementary
       to hppa.s. Contains only the printversion() program and the 2 line
       mulmodll() program.
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. Contains only the printversion() program and the 2 line
       mulmodll() program.
versionsparcv8.c: level 0 kernel of PARI for the sparc version, complementary
       to sparcv8.s. Contains only the printversion() program and the 2 line
       mulmodll() program.

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          439 Jul  4 20:15 Makefile
-rw-r--r--  1 pari        11417 Sep 10 17:40 appa.tex
-rw-r--r--  1 pari          683 Feb  7  1993 appb.tex
-rw-r--r--  1 pari         2090 Feb  7  1993 appc.tex
-rw-r--r--  1 pari         2155 Feb  7  1993 appd.tex
-rw-r--r--  1 pari          350 Sep 10 17:41 titlepage.tex
-rw-r--r--  1 pari       109781 Sep  7 14:27 tutorial.tex
-rw-r--r--  1 pari         4305 Sep  2 14:53 users.tex
-rw-r--r--  1 pari        17664 Aug  8 00:56 usersch1.tex
-rw-r--r--  1 pari        22837 May  3 00:03 usersch2.tex
-rw-r--r--  1 pari       183453 Sep  7 14:27 usersch3.tex
-rw-r--r--  1 pari        57184 Jul 10 20:34 usersch4.tex
-rw-r--r--  1 pari        31799 Feb  7  1993 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 (almost finished).
users.tex: TeX driver file for the manual.

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

-rw-rw-r--  1 pari         3171 Sep  7 01:23 EXPLAIN
-rw-r--r--  1 pari          146 Feb  7  1993 Makefile
-rw-r--r--  1 pari          115 Feb  7  1993 Makesimple
-rw-r--r--  1 pari          100 Aug  5 19:33 bench.gp
-rw-r--r--  1 pari         2170 Feb  7  1993 clareg.gp
-rw-r--r--  1 pari           52 Aug  5 19:33 lucas.gp
-rw-r--r--  1 pari         1483 May  3 00:06 mattrans.c
-rw-r--r--  1 pari          260 Aug  5 19:36 rho.gp
-rw-r--r--  1 pari          709 Feb  7  1993 squfof.gp
-rw-r--r--  1 pari         1712 Sep 15 17:03 tutnf.gp
-rw-rw-r--  1 pari         7564 Sep 15 17:05 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: output of tutnf.gp
