Return to README.DOS CVS log

Up to [local] / OpenXM_contrib / pari-2.2

Annotation of OpenXM_contrib/pari-2.2/README.DOS, Revision 1.1.1.1

1.1       noro        1: PARI/GP is developped and tested in the Unix world, but has been partly
                      2: ported to DOS/Windows using the EMX/RSX runtime packages. The resulting
                      3: binary GP.EXE should be usable on most DOS-based platforms, although it won't
                      4: share the traditional look and feel of e.g native Windows programs. Binaries
                      5: may or may not be available after each Unix release.
                      6:
                      7: Everything written in this file applies to DOS 3.0 or higher, OS/2 2.0 or
                      8: higher, and Windows 3.1. An 80386 CPU or higher is required in any case.
                      9:
                     10: See README.WIN for more recent versions of Windows (95 or higher).
                     11: %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
                     12:
                     13: I: What's in there ?
                     14: --------------------
                     15:
                     16: The DOS archive is divided in 4 parts: the first 2 (GPB, GPD) change each
                     17: time an update is made, the last two (GPRT, GPRL) need only be downloaded
                     18: once, if at all. The complete sources are distributed in the Unix version,
                     19: but are not required unless you want to compile GP or the PARI library
                     20: yourself.
                     21:
                     22: xxxx stands for a version number
                     23:
                     24: 1) Binary (GPB): GPB_xxxx.ZIP
                     25:   + GP.EXE binary, linked with GNU readline
                     26:   + various README files
                     27:
                     28:   GP.EXE is an EMX executable; it it doesn't start up, check EMX\EMXRT.DOC
                     29:   (DOS, OS/2) or RSX\README.TXT (Windows). The runtime packages themselves
                     30:   are in GPRT.ZIP. Note that GP.EXE is twice slower than a native Linux binary.
                     31:
                     32: 2) Documentation and Examples (GPD): GPD_xxxx.ZIP, containing the directories
                     33:   + DOC, containing
                     34:      - user's manual, tutorial and reference card in TeX format You wil
                     35:        need TeX to compile them (see www.CTAN.org for how to get TeX) The
                     36:        same documents are available in PDF and PostScript format from
                     37:
                     38:          ftp://megrez.math.u-bordeaux.fr/pub/pari/manuals/
                     39:
                     40:      - the script GPHELP (translates Pari documentation to plain text and
                     41:        handles "apropos help"), which requires PERL (see www.CPAN.org for how
                     42:        to get it). You may have to fix paths in the first lines of the script.
                     43:        Set your GPRC file so that the 'help' default points to the place where
                     44:        you deposit GPHELP (see MISC/GPRC.DOS).
                     45:
                     46:   + MISC, containing
                     47:       - a sample GPRC file (GPRC.DOS). Copy it to C:\_GPRC (or \etc\GPRC) and
                     48:         adapt it to your needs
                     49:       - a sample alias file (GPALIAS).
                     50:
                     51:   + EXAMPLES, containing sample GP scripts
                     52:
                     53:
                     54: 3) EMX/RSX runtime package (GPRT): GPRT.ZIP
                     55:   files you will need if the provided binary GP.EXE doesn't work as is.
                     56:
                     57: 4) Readline (GPRL): GPRL.ZIP
                     58:   source of the modified readline library (version 1.0) used to compile GP.EXE
                     59:
                     60: The files can be extracted using UNZIP or PKUNZIP -D (don't forget the -D).
                     61: Depending on what you want to do, the files you need are (X = required, [X] =
                     62: optional)
                     63:
                     64:     To run GP |  To compile libpari | To compile GP
                     65:               |                     |
                     66: GPB      X    |                     |
                     67: GPD     [X]   |                     |
                     68: GPRT     X    |                     |
                     69: GPRL          |                     |       X
                     70: sources       |           X         |       X
                     71: galdata [X]   |                     |
                     72:
                     73: 'sources' refers to the generic Unix distribution archive (pari.tgz).
                     74: 'galdata' is the file galdata.tgz which can be found at the same place as
                     75: pari.tgz. It is only needed to compute the Galois group of polynomials of
                     76: degree 8 to 11 (higher degrees not implemented).
                     77:
                     78: %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
                     79:
                     80: II: What do I do with it ?
                     81: --------------------------
                     82:   1) I only want to use GP.EXE
                     83:
                     84: * For DOS: install EMX.EXE from GPRT somewhere in your path.  If you have
                     85: enough RAM (~ 2MB), you can run GP.EXE as is, but some functionalities
                     86: (extended help, external commands) will only be available if you use the
                     87: command line EMX -P GP.EXE. Put that in a GP.BAT file, or (preferably)
                     88: fetch a decent shell (e.g. bash) and use an alias.
                     89:
                     90: * For Windows: install RSX.EXE from GPRT somewhere in your path.
                     91:
                     92: * For OS/2: untested. You may need EMX.DLL from GPRT.
                     93:
                     94: In all cases, if you want to use the polgalois function for polynomials of
                     95: degree 8 to 11, fetch galdata.tgz and extract it in \pari\data (can't be
                     96: customized without recompiling).
                     97:
                     98:   2) I want to build the PARI library for my own C programs
                     99:
                    100: You need the _complete_ EMX package (not the runtime files we provide) and a
                    101: make utility (see EMX\README.DOC; dmake and GNU make are both ok).
                    102:
                    103: Fetch the Unix source distribution (tar and basic shell utilities needed to
                    104: extract it). Then, from the distribution top directory:
                    105:
                    106:   cd Odos
                    107:   make lib
                    108:
                    109:   3) I also want to recompile GP.EXE
                    110:
                    111: You need the GPRL archive (extract it from the distribution top directory).
                    112:
                    113:   cd readline
                    114:   dmake
                    115:   cd ..
                    116:   cd Odos
                    117:   dmake
                    118:
                    119:   4) I want to run the benches
                    120:
                    121: Build GP.EXE first (or extract the binary from GPB and put it in the 'Odos'
                    122: subdirectory), then type
                    123:
                    124:   cd Odos
                    125:   ..\src\test\dotest
                    126:
                    127: (decent shell and basic Unix tools needed: the djgpp ports of bash and GNU
                    128: binutils work nicely, Ian Stewartson's tools are also ok). Make sure FILES
                    129: is at least 50 in CONFIG.SYS. Bash and sh may run out of memory during the
                    130: bench.