Brief guide to the PARI files.

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


-rw-rw-r--  1 pari         1609 Sep 26 13:11 Buglist
-rw-rw-r--  1 pari         8301 Dec  3 17:19 Changes
-rw-rw-r--  1 pari        47459 Sep 26 13:11 Changes1.31-1.35
-rw-rw-r--  1 pari        24033 Sep 26 13:11 Changes1.35-1.37
-rw-rw-r--  1 pari        11540 Dec  4 14:10 FILES
-rw-rw-r--  1 pari         7441 Sep 26 13:11 INSTALLATION
-rw-rw-r--  1 pari         1214 Sep 26 13:11 Makefile.hppa
-rw-rw-r--  1 pari         2780 Sep 26 13:11 Makefile.port
-rw-rw-r--  1 pari         2044 Sep 26 13:11 Makefile.sun3
-rw-rw-r--  1 pari         2057 Sep 26 13:11 Makefile.sun4
-rw-rw-r--  1 pari        10749 Sep 26 13:11 Newin1.37
-rw-rw-r--  1 pari         2688 Oct 16 00:25 Newin1.38
-rw-rw-r--  1 pari         2815 Sep 26 13:11 README
-rw-rw-r--  1 pari        32465 Dec  4 10:54 alglin1.c
-rw-rw-r--  1 pari        34453 Oct 21 23:03 alglin2.c
-rw-rw-r--  1 pari        46650 Oct 28 11:50 anal.c
-rw-rw-r--  1 pari        44734 Oct 21 23:03 arith1.c
-rw-rw-r--  1 pari        33933 Oct 21 23:03 arith2.c
-rw-rw-r--  1 pari        59235 Nov  7 16:56 base.c
-rw-rw-r--  1 pari        69347 Nov 26 16:13 bibli1.c
-rw-rw-r--  1 pari        50045 Oct 21 23:03 bibli2.c
-rw-rw-r--  1 pari        79707 Dec  3 17:00 buch.c
-rw-rw-r--  1 pari          901 Oct 21 23:03 dummy.c
-rw-rw-r--  1 pari        54883 Oct 21 23:03 elliptic.c
-rw-rw-r--  1 pari         5177 Oct 21 23:03 erreurs.h
-rw-rw-r--  1 pari        18579 Oct 21 23:03 errmessages.c
-rw-rw-r--  1 pari        41053 Oct 21 23:03 es.c
drwxrwxr-x  2 pari          512 Oct 17 00:39 examples/
-rw-rw-r--  1 pari        45233 Oct 21 23:03 gen1.c
-rw-rw-r--  1 pari        51615 Oct 21 23:03 gen2.c
-rw-rw-r--  1 pari        52752 Oct 21 23:03 gen3.c
-rw-rw-r--  1 pari         1655 Oct 21 23:03 gen68k.h
-rw-rw-r--  1 pari        23443 Oct 28 11:51 gencom.h
-rw-rw-r--  1 pari          310 Oct 21 23:03 genpari68k.h
-rw-rw-r--  1 pari          311 Oct 21 23:03 genpariother.h
-rw-rw-r--  1 pari         4997 Oct 21 23:03 genport.h
-rw-rw-r--  1 pari        16839 Oct 21 23:03 gp.c
-rw-rw-r--  1 pari        17892 Oct 21 23:03 gpreadline.c
-rw-rw-r--  1 pari        31563 Oct 27 20:38 helpmessages.c
-rw-rw-r--  1 pari         3635 Oct 21 23:03 hppa.s
-rw-rw-r--  1 pari         9860 Oct 21 23:03 init.c
-rw-rw-r--  1 pari       168040 Sep 26 13:11 mp.ami
-rw-rw-r--  1 pari        37345 Oct 21 23:03 mp.c
-rw-rw-r--  1 pari       126270 Oct 21 23:03 mp.news
-rw-rw-r--  1 pari       256100 Oct 14 15:38 mp.s
-rw-r--r--  1 pari        25747 Sep 26 13:11 pari.el
-rw-r--r--  1 pari        20582 Sep 26 13:11 pari.el-changes
-rw-rw-r--  1 pari        16633 Oct  1 09:28 pari.elc
-rw-rw-r--  1 pari         3274 Oct 12 19:12 pari.menu
-rw-r--r--  1 pari         9737 Sep 26 13:11 pari.txt
-rw-rw-r--  1 pari        15572 Oct 21 23:03 plotX.c
-rw-rw-r--  1 pari          160 Oct 21 23:03 plotnull.c
-rw-rw-r--  1 pari        12724 Oct 21 23:03 plotsun.c
-rw-rw-r--  1 pari        60974 Oct 21 23:03 polarit1.c
-rw-rw-r--  1 pari        42810 Oct 21 23:03 polarit2.c
-rw-rw-r--  1 pari         9975 Oct 28 16:08 sparcv7.s
-rw-rw-r--  1 pari         2837 Oct 23 14:50 sparcv8.s
-rw-rw-r--  1 pari         9676 Oct 16 22:55 testin
-rw-rw-r--  1 pari        47681 Dec  4 14:06 testout
-rw-rw-r--  1 pari          739 Sep 26 13:11 testplotin
drwxrwxr-x  2 pari          512 Dec  3 17:20 tex/
-rw-rw-r--  1 pari        33231 Dec  4 10:59 trans1.c
-rw-rw-r--  1 pari        44586 Oct 21 23:03 trans2.c
-rw-rw-r--  1 pari        32633 Oct 21 23:03 trans3.c
-rw-rw-r--  1 pari         4979 Dec  3 16:58 version68k.c
-rw-rw-r--  1 pari          251 Dec  3 16:57 versionhp.c
-rw-rw-r--  1 pari         3969 Dec  3 16:57 versionport.c
-rw-rw-r--  1 pari          252 Dec  3 16:57 versionsparc.c


Buglist: contains a list of modifications to be made to PARI (in french).
Changes: contains a sometimes brief description of the list of changes since
        version 1.37 (in french).
Changes1.35-1.37: same, from version 1.35 to 1.37.
Changes1.31-1.35: same, from version 1.31 to 1.35.
FILES: this file
INSTALLATION: detailed description of the installation procedure on Unix 
       systems. Similar to appendix A of the manual.
Makefile.hppa: Makefile for the HP-PA version (230 lines of assembly code).
Makefile.port: Makefile for the port version (no assembler at all).
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).
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 (for the moment in disorganized
       form).
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.
buch.c: specialized package for sub-exponential class group and regulator
       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.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.
pari.el: emacs-lisp file contributed by David Carlisle which gives a much
       nicer user interface for GP in a GNUemacs buffer. Version 2.10.
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.
sparc.s: level 0 kernel of PARI in 484 lines of Sparc assembly language,
       simulating the basic instructions on 32 and 64 bits.
sparcv8.s: level 0 kernel of PARI in 100 lines of Sparc version 8 assembly
       language, simulating the basic instructions on 32 and 64 bits. This
       has not been tested yet.
testin: test suite for gp.
testplotin: test suite for the plotting and postscript functions of 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.
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.
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          434 Sep  3 16:09 Makefile
-rw-rw-r--  1 pari         8160 Sep  8 01:27 appa.tex
-rw-rw-r--  1 pari          683 May 20  1992 appb.tex
-rw-rw-r--  1 pari         2090 May 20  1992 appc.tex
-rw-rw-r--  1 pari         2155 Jun  4  1992 appd.tex
-rw-rw-r--  1 pari          353 Dec  3 17:20 titlepage.tex
-rw-rw-r--  1 pari        70373 Nov 12 23:31 tutorial.tex
-rw-r--r--  1 pari         4209 Dec  3 17:20 users.tex
-rw-rw-r--  1 pari        17484 Jun  5  1992 usersch1.tex
-rw-rw-r--  1 pari        22679 Sep 16 14:07 usersch2.tex
-rw-rw-r--  1 pari       164293 Oct 23 19:23 usersch3.tex
-rw-rw-r--  1 pari        56503 May 20  1992 usersch4.tex
-rw-rw-r--  1 pari        31799 Jun  4  1992 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 quite finished).
users.tex: TeX driver file for the manual.

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


-rw-rw-r--  1 pari          141 May 20  1992 Makefile
-rw-rw-r--  1 pari          109 May 20  1992 Makesimple
-rw-rw-r--  1 pari         2170 May 20  1992 clareg.gp
-rw-rw-r--  1 pari         1473 May 20  1992 mattrans.c
-rw-rw-r--  1 pari          709 May 20  1992 squfof.gp
-rw-rw-r--  1 pari          802 Oct 17 00:39 tutnf.gp


Makefile: for the mattrans.c of chapter 4 and appendix C.
Makesimple: simple Makefile for gp itself.
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
mattrans.c: simple example C program using the PARI library for computing the
      exponential of a matrix.
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.
