home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / progs / pari / pari_137 / files.ori < prev    next >
Text File  |  1992-05-20  |  11KB  |  218 lines

  1. Brief guide to the PARI files.
  2.  
  3. In the main directory, you should have the following files:
  4.  
  5.  
  6. -rw-r--r--  1 guest        1341 May 20 15:13 Buglist
  7. -rw-r--r--  1 guest         289 May 20 15:13 Changes
  8. -rw-r--r--  1 guest       47459 May 20 15:13 Changes1.31-1.35
  9. -rw-r--r--  1 guest       24033 May 20 15:13 Changes1.35-1.37
  10. -rw-r--r--  1 guest       11371 May 20 16:07 FILES
  11. -rw-r--r--  1 guest        7396 May 20 15:13 INSTALLATION
  12. -rw-r--r--  1 guest        1982 May 20 15:13 Makefile
  13. -rw-r--r--  1 guest        1155 May 20 15:13 Makefile.hppa
  14. -rw-r--r--  1 guest        2733 May 20 15:13 Makefile.port
  15. -rw-r--r--  1 guest        2012 May 20 15:13 Makefile.sun3
  16. -rw-r--r--  1 guest        2056 May 20 15:13 Makefile.sun4
  17. -rw-r--r--  1 guest       10749 May 20 15:13 Newin1.37
  18. -rw-r--r--  1 guest        2771 May 20 15:17 README
  19. -rw-r--r--  1 guest       29002 May 20 15:13 alglin1.c
  20. -rw-r--r--  1 guest       34249 May 20 15:13 alglin2.c
  21. -rw-r--r--  1 guest       45169 May 20 15:13 anal.c
  22. -rw-r--r--  1 guest       44719 May 20 15:13 arith1.c
  23. -rw-r--r--  1 guest       33595 May 20 15:13 arith2.c
  24. -rw-r--r--  1 guest       36114 May 20 15:13 base.c
  25. -rw-r--r--  1 guest       67984 May 20 15:13 bibli1.c
  26. -rw-r--r--  1 guest       47201 May 20 15:13 bibli2.c
  27. -rw-r--r--  1 guest       47444 May 20 15:13 buch.c
  28. -rw-r--r--  1 guest         458 May 20 15:13 dummy.c
  29. -rw-r--r--  1 guest       54770 May 20 15:13 elliptic.c
  30. -rw-r--r--  1 guest        5177 May 20 15:13 erreurs.h
  31. -rw-r--r--  1 guest       18578 May 20 15:13 errmessages.c
  32. -rw-r--r--  1 guest       41053 May 20 15:13 es.c
  33. drwxr-xr-x  2 guest         512 May 20 15:13 examples/
  34. -rw-r--r--  1 guest       45233 May 20 15:13 gen1.c
  35. -rw-r--r--  1 guest       51566 May 20 15:13 gen2.c
  36. -rw-r--r--  1 guest       52288 May 20 15:13 gen3.c
  37. -rw-r--r--  1 guest        1655 May 20 15:13 gen68k.h
  38. -rw-r--r--  1 guest       23130 May 20 15:13 gencom.h
  39. -rw-r--r--  1 guest         310 May 20 15:13 genpari68k.h
  40. -rw-r--r--  1 guest         311 May 20 15:13 genpariother.h
  41. -rw-r--r--  1 guest        4997 May 20 15:13 genport.h
  42. -rw-r--r--  1 guest       14663 May 20 15:13 gp.c
  43. -rw-r--r--  1 guest       15235 May 20 15:13 gpreadline.c
  44. -rw-r--r--  1 guest       29434 May 20 15:14 helpmessages.c
  45. -rw-r--r--  1 guest        3635 May 20 15:14 hppa.s
  46. -rw-r--r--  1 guest        9784 May 20 15:14 init.c
  47. -rw-r--r--  1 guest      168040 May 20 15:14 mp.ami
  48. -rw-r--r--  1 guest       37345 May 20 15:14 mp.c
  49. -rw-r--r--  1 guest      126296 May 20 15:14 mp.news
  50. -rw-r--r--  1 guest      256100 May 20 15:14 mp.s
  51. -rw-r--r--  1 guest       20344 May 20 15:14 pari.el
  52. -rw-r--r--  1 guest       13917 May 20 15:14 pari.elc
  53. -rw-r--r--  1 guest        3138 May 20 15:14 pari.menu
  54. -rw-r--r--  1 guest        8776 May 20 15:14 pari.txt
  55. -rw-r--r--  1 guest       14980 May 20 15:14 plot.X
  56. -rw-r--r--  1 guest       14980 May 20 15:14 plot.c
  57. -rw-r--r--  1 guest         160 May 20 15:14 plot.null
  58. -rw-r--r--  1 guest       12184 May 20 15:59ls -l FILES plot.sun
  59. -rw-r--r--  1 guest       52735 May 20 15:14 polarit1.c
  60. -rw-r--r--  1 guest       42664 May 20 15:14 polarit2.c
  61. -rw-r--r--  1 guest        9975 May 20 15:14 sparc.s
  62. -rw-r--r--  1 guest        2468 May 20 15:14 sparcv8.s
  63. -rw-r--r--  1 guest        9303 May 20 15:14 testin
  64. -rw-r--r--  1 guest       44378 May 20 16:04 testout
  65. -rw-r--r--  1 guest         717 May 20 15:14 testplotin
  66. drwxr-xr-x  2 guest         512 May 20 15:14 tex/
  67. -rw-r--r--  1 guest       33170 May 20 15:14 trans1.c
  68. -rw-r--r--  1 guest       44578 May 20 15:14 trans2.c
  69. -rw-r--r--  1 guest       32605 May 20 15:14 trans3.c
  70. -rw-r--r--  1 guest        4977 May 20 15:18 version68k.c
  71. -rw-r--r--  1 guest         249 May 20 15:19 versionhp.c
  72. -rw-r--r--  1 guest        3967 May 20 15:18 versionport.c
  73. -rw-r--r--  1 guest         250 May 20 15:19 versionsparc.c
  74.  
  75.  
  76. Buglist: contains a list of modifications to be made to PARI (in french).
  77. Changes: contains a sometimes brief description of the list of changes since
  78.         version 1.37 (in french).
  79. Changes1.35-1.37: same, from version 1.35 to 1.37.
  80. Changes1.31-1.35: same, from version 1.31 to 1.35.
  81. FILES: this file
  82. INSTALLATION: detailed description of the installation procedure on Unix 
  83.        systems. Similar to appendix A of the manual.
  84. Makefile.hppa: Makefile for the HP-PA version (230 lines of assembly code).
  85. Makefile.port: Makefile for the port version (no assembler at all).
  86. Makefile.sun3: Makefile for the 68k version (more than 6000 lines of assembly
  87.        code). Contrary to what its name may imply, it can be used on other
  88.        680x0 machines with x>=2.
  89. Makefile.sun4: Makefile for the sparc version (484 lines of assembly code).
  90. Newin1.37: New features of version 1.37 compared to version 1.35 (must
  91.        be read by users of versions 1.35, and also by users of version
  92.        1.36).
  93. README: General information about copyright, copying and spreading PARI, where
  94.        to send bug reports.
  95.  
  96. alglin1.c, alglin2.c: linear algebra package.
  97. anal.c: line-oriented syntactical analyser/parser.
  98. arith1.c, arith2.c: number-theoretic package.
  99. base.c: specialized package for algebraic number theory.
  100. bibli1.c, bibli2.c: miscellaneous routines.
  101. buch.c: specialized package for sub-exponential class group and regulator
  102.        algorithms (McCurley, Buchmann).
  103. dummy.c: contains dummy declarations of the functions which are not going to be
  104.        part of the library libpari.a, for example the plotting routines.
  105. elliptic.c: specialized package for working with elliptic curves.
  106. erreurs.h: include file containing pointers to error messages.
  107. errmessages.c: all error messages.
  108. es.c: input-output routines.
  109. gen1.c, gen2.c, gen3.c: second level kernel of PARI: deals with all the
  110.        elementary operations between all the PARI types.
  111. gen68k.h: specific include file for the 68k versions.
  112. gencom.h: common include file to all versions.
  113. genpari68k.h: file to be included in any program using PARI including PARI
  114.        itself, for 68k versions. Includes gen68k.h.
  115. genpariother.h: same but for non68k versions. Includes genport.h.
  116. genport.h: specific include file for non68k versions.
  117. gp.c: main program, including treatment of commands.
  118. gpreadline.c: same as gp.c, with code added to support the GNU readline
  119.        library. 
  120. helpmessages.c: short help messages for the internal functions obtained by
  121.        ?function.
  122. hppa.s: level 0 kernel of PARI in 230 lines of HP-PA assembly language,
  123.        simulating the basic instructions on 32 and 64 bits.
  124. init.c: initialization procedures for PARI. The init() program must be called
  125.        by any program using PARI (including gp) before doing any PARI 
  126.        operations.
  127. mp.ami: First level kernel of PARI, more than 6000 lines of MC68020 assembler,
  128.        here using the Lattice syntax on the Amiga 2500 or above.
  129. mp.c: In conjunction with versionport.c or sparc.s, first level kernel of
  130.        PARI, written in C.
  131. mp.news: same as mp.ami, using the Sony News assembler syntax.
  132. mp.s: same as mp.ami, using the Sun 3 assembler syntax.
  133. pari.el: emacs-lisp file contributed by David Carlisle which gives a much
  134.        nicer user interface for GP in a GNUemacs buffer.
  135. pari.elc: byte-compiled version of pari.el.
  136. pari.menu: file used for the menu-driven help in the GP emacs buffer.
  137. pari.txt: text explaining how to install and use pari.el and pari.menu.
  138. plot.X: hires plot routines under the X11 window system. Note that this
  139.        works on systems layered above X11 such as Sun's Openwindows or Motif.
  140. plot.null: same when neither X11 nor sunview is available, so no hires plot
  141.        is possible.
  142. plot.sun: same as plot.X for the sunview/suntools window system.
  143. polarit1.c, polarit2.c: polynomial package.
  144. sparc.s: level 0 kernel of PARI in 484 lines of Sparc assembly language,
  145.        simulating the basic instructions on 32 and 64 bits.
  146. sparcv8.s: level 0 kernel of PARI in 100 lines of Sparc version 8 assembly
  147.        language, simulating the basic instructions on 32 and 64 bits. This
  148.        has not been tested yet.
  149. testin: test suite for gp.
  150. testplotin: test suite for the plotting and postscript functions of gp.
  151. testout: what the result of gp<testin should be.
  152. trans1.c, trans2.c, trans3.c: transcendental functions package.
  153. version68k.c: level 0 kernel of PARI for the 68k version. Contains only the
  154.        printversion() program and a program used for debugging.
  155. versionhp.c: level 0 kernel of PARI for the sparc version, complementary
  156.        to hppa.s. Contains only the printversion() program and the 2 line
  157.        mulmodll() program.
  158. versionport.c: level 0 kernel of PARI for the port (not 68k or sparc) version,
  159.        entirely in C, simulating the basic instructions on 32 and 64 bits.
  160. versionsparc.c: level 0 kernel of PARI for the sparc version, complementary
  161.        to sparc.s. Contains only the printversion() program and the 2 line
  162.        mulmodll() program.
  163.  
  164. In the tex subdirectory, you should have the following files corresponding
  165. to the tex source for the user's manual:
  166.  
  167.  
  168. -rw-r--r--  1 guest         390 May 20 15:14 Makefile
  169. -rw-r--r--  1 guest        8089 May 20 15:14 appa.tex
  170. -rw-r--r--  1 guest         683 May 20 15:14 appb.tex
  171. -rw-r--r--  1 guest        2090 May 20 15:14 appc.tex
  172. -rw-r--r--  1 guest        2155 May 20 15:14 appd.tex
  173. -rw-r--r--  1 guest        1326 May 20 15:14 index.tex
  174. -rw-r--r--  1 guest         349 May 20 15:14 titlepage.tex
  175. -rw-r--r--  1 guest       32302 May 20 15:14 tutorial.tex
  176. -rw-r--r--  1 guest        2353 May 20 15:14 users.tex
  177. -rw-r--r--  1 guest       17477 May 20 15:14 usersch1.tex
  178. -rw-r--r--  1 guest       21771 May 20 15:14 usersch2.tex
  179. -rw-r--r--  1 guest      153103 May 20 15:14 usersch3.tex
  180. -rw-r--r--  1 guest       56503 May 20 15:14 usersch4.tex
  181. -rw-r--r--  1 guest       31798 May 20 15:14 usersch5.tex
  182.  
  183.  
  184. Makefile: for making the manual.
  185. usersch1.tex: chapter 1, overview of the PARI system.
  186. usersch2.tex: chapter 2, specific use of the GP calculator.
  187. usersch3.tex: chapter 3, functions and operations available in PARI and GP.
  188. usersch4.tex: chapter 4, programming PARI in library mode.
  189. usersch5.tex: chapter 5, technical reference guide for low level functions.
  190. appa.tex: appendix A, installation guide for the UNIX versions.
  191. appb.tex: appendix B, a sample Makefile.
  192. appc.tex: appendix C, a complete program.
  193. appd.tex: appendix D, summary of available constants.
  194. titlepage.tex: cover page for the manual.
  195. tutorial.tex: a GP tutorial (not quite finished).
  196. users.tex: TeX driver file for the manual.
  197. index.tex: TeX driver file for the index (automatically generated by the
  198.        Makefile).
  199.  
  200. In the examples subdirectory, you should have the following files:
  201.  
  202.  
  203. -rw-r--r--  1 guest         141 May 20 15:13 Makefile
  204. -rw-r--r--  1 guest         109 May 20 15:13 Makesimple
  205. -rw-r--r--  1 guest        2170 May 20 15:13 clareg.gp
  206. -rw-r--r--  1 guest        1473 May 20 15:13 mattrans.c
  207. -rw-r--r--  1 guest         709 May 20 15:13 squfof.gp
  208.  
  209.  
  210. Makefile: for the mattrans.c of chapter 4 and appendix C.
  211. Makesimple: simple Makefile for gp itself.
  212. clareg.gp: a complete GP program for computing class groups and units in 
  213.       general number fields, to be read under GP with the command \r clareg.gp
  214. mattrans.c: simple example C program using the PARI library for computing the
  215.       exponential of a matrix.
  216. squfof.gp: a complete GP program for Shanks's SQUFOF factoring method, to be
  217.       read under GP with the command \r squfof.gp.
  218.