Brief guide to the PARI files.

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


-rw-r--r--  1 guest        1341 May 20 15:13 Buglist
-rw-r--r--  1 guest         289 May 20 15:13 Changes
-rw-r--r--  1 guest       47459 May 20 15:13 Changes1.31-1.35
-rw-r--r--  1 guest       24033 May 20 15:13 Changes1.35-1.37
-rw-r--r--  1 guest       11371 May 20 15:27 FILES
-rw-r--r--  1 guest        7396 May 20 15:13 INSTALLATION
-rw-r--r--  1 guest        1982 May 20 15:13 Makefile
-rw-r--r--  1 guest        1155 May 20 15:13 Makefile.hppa
-rw-r--r--  1 guest        2733 May 20 15:13 Makefile.port
-rw-r--r--  1 guest        2012 May 20 15:13 Makefile.sun3
-rw-r--r--  1 guest        2056 May 20 15:13 Makefile.sun4
-rw-r--r--  1 guest       10749 May 20 15:13 Newin1.37
-rw-r--r--  1 guest        2771 May 20 15:17 README
-rw-r--r--  1 guest       29002 May 20 15:13 alglin1.c
-rw-r--r--  1 guest       34249 May 20 15:13 alglin2.c
-rw-r--r--  1 guest       45169 May 20 15:13 anal.c
-rw-r--r--  1 guest       44719 May 20 15:13 arith1.c
-rw-r--r--  1 guest       33595 May 20 15:13 arith2.c
-rw-r--r--  1 guest       36114 May 20 15:13 base.c
-rw-r--r--  1 guest       67984 May 20 15:13 bibli1.c
-rw-r--r--  1 guest       47201 May 20 15:13 bibli2.c
-rw-r--r--  1 guest       47444 May 20 15:13 buch.c
-rw-r--r--  1 guest         458 May 20 15:13 dummy.c
-rw-r--r--  1 guest       54770 May 20 15:13 elliptic.c
-rw-r--r--  1 guest        5177 May 20 15:13 erreurs.h
-rw-r--r--  1 guest       18578 May 20 15:13 errmessages.c
-rw-r--r--  1 guest       41053 May 20 15:13 es.c
drwxr-xr-x  2 guest         512 May 20 15:13 examples/
-rw-r--r--  1 guest       45233 May 20 15:13 gen1.c
-rw-r--r--  1 guest       51566 May 20 15:13 gen2.c
-rw-r--r--  1 guest       52288 May 20 15:13 gen3.c
-rw-r--r--  1 guest        1655 May 20 15:13 gen68k.h
-rw-r--r--  1 guest       23130 May 20 15:13 gencom.h
-rw-r--r--  1 guest         310 May 20 15:13 genpari68k.h
-rw-r--r--  1 guest         311 May 20 15:13 genpariother.h
-rw-r--r--  1 guest        4997 May 20 15:13 genport.h
-rw-r--r--  1 guest       14663 May 20 15:13 gp.c
-rw-r--r--  1 guest       15235 May 20 15:13 gpreadline.c
-rw-r--r--  1 guest       29434 May 20 15:14 helpmessages.c
-rw-r--r--  1 guest        3635 May 20 15:14 hppa.s
-rw-r--r--  1 guest        9784 May 20 15:14 init.c
-rw-r--r--  1 guest      168040 May 20 15:14 mp.ami
-rw-r--r--  1 guest       37345 May 20 15:14 mp.c
-rw-r--r--  1 guest      126296 May 20 15:14 mp.news
-rw-r--r--  1 guest      256100 May 20 15:14 mp.s
-rw-r--r--  1 guest       20344 May 20 15:14 pari.el
-rw-r--r--  1 guest       13917 May 20 15:14 pari.elc
-rw-r--r--  1 guest        3138 May 20 15:14 pari.menu
-rw-r--r--  1 guest        8776 May 20 15:14 pari.txt
-rw-r--r--  1 guest       14980 May 20 15:14 plot.X
-rw-r--r--  1 guest       14980 May 20 15:14 plot.c
-rw-r--r--  1 guest         160 May 20 15:14 plot.null
-rw-r--r--  1 guest       12184 May 20 15:14 plot.sun
-rw-r--r--  1 guest       52735 May 20 15:14 polarit1.c
-rw-r--r--  1 guest       42664 May 20 15:14 polarit2.c
-rw-r--r--  1 guest        9975 May 20 15:14 sparc.s
-rw-r--r--  1 guest        2468 May 20 15:14 sparcv8.s
-rw-r--r--  1 guest        9303 May 20 15:14 testin
-rw-r--r--  1 guest       44379 May 20 15:18 testout
-rw-r--r--  1 guest         717 May 20 15:14 testplotin
drwxr-xr-x  2 guest         512 May 20 15:14 tex/
-rw-r--r--  1 guest       33170 May 20 15:14 trans1.c
-rw-r--r--  1 guest       44578 May 20 15:14 trans2.c
-rw-r--r--  1 guest       32605 May 20 15:14 trans3.c
-rw-r--r--  1 guest        4977 May 20 15:18 version68k.c
-rw-r--r--  1 guest         249 May 20 15:19 versionhp.c
-rw-r--r--  1 guest        3967 May 20 15:18 versionport.c
-rw-r--r--  1 guest         250 May 20 15:19 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).
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.
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.
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 guest         390 May 20 15:14 Makefile
-rw-r--r--  1 guest        8089 May 20 15:14 appa.tex
-rw-r--r--  1 guest         683 May 20 15:14 appb.tex
-rw-r--r--  1 guest        2090 May 20 15:14 appc.tex
-rw-r--r--  1 guest        2155 May 20 15:14 appd.tex
-rw-r--r--  1 guest        1326 May 20 15:14 index.tex
-rw-r--r--  1 guest         349 May 20 15:14 titlepage.tex
-rw-r--r--  1 guest       32302 May 20 15:14 tutorial.tex
-rw-r--r--  1 guest        2353 May 20 15:14 users.tex
-rw-r--r--  1 guest       17477 May 20 15:14 usersch1.tex
-rw-r--r--  1 guest       21771 May 20 15:14 usersch2.tex
-rw-r--r--  1 guest      153103 May 20 15:14 usersch3.tex
-rw-r--r--  1 guest       56503 May 20 15:14 usersch4.tex
-rw-r--r--  1 guest       31798 May 20 15:14 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.
index.tex: TeX driver file for the index (automatically generated by the
       Makefile).

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


-rw-r--r--  1 guest         141 May 20 15:13 Makefile
-rw-r--r--  1 guest         109 May 20 15:13 Makesimple
-rw-r--r--  1 guest        2170 May 20 15:13 clareg.gp
-rw-r--r--  1 guest        1473 May 20 15:13 mattrans.c
-rw-r--r--  1 guest         709 May 20 15:13 squfof.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.
