Return to README.DOS CVS log

Up to [local] / OpenXM_contrib / pari

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

1.1       maekawa     1: PARI/GP is developped and tested in the Unix world. Since sticking to Unix
                      2: would prevent many users from enjoying the system [not everybody wants to
                      3: install Linux], PARI has been (partly) ported to DOS using the EMX runtime
                      4: package. The resulting binary GP.EXE should be usable on most DOS-based
                      5: platforms, although it won't share the traditional look and feel of e.g
                      6: native Windows programs. Binaries may or may not be available after each
                      7: Unix release.
                      8:
                      9: Everything written in this file applies to DOS 3.0 or higher, OS/2 2.0 and
                     10: higher, and Windows 3.1 (unless noted otherwise). It seems that GP.EXE runs
                     11: more or less correctly in a DOS window under Windows 95/98/NT, but this has
                     12: not been extensively tested. An 80386 CPU or higher is required in any case.
                     13: =============================================================================
                     14:
                     15: I: What's in there ?
                     16: --------------------
                     17:
                     18: The DOS archive is divided in 5 parts: the first 3 will change each time an
                     19: update is made (xxxx stands for a version number), the last two need only be
                     20: downloaded once, if at all. The complete sources are distributed in the Unix
                     21: version, but are not required unless you want to compile GP or the PARI
                     22: library yourself.
                     23:
                     24: 1) Binaries (GPB): GPB_xxxx.ZIP
                     25:   + GP.EXE binary, linked with GNU readline
                     26:   + an EXAMPLES directory, containing sample GP scripts and a GPRC file
                     27:     (copy the latter to C:\_GPRC and adapt it to your needs)
                     28:
                     29:   GP.EXE is an EMX executable; it it doesn't start up, check EMX\EMXRT.DOC
                     30:   (DOS, OS/2) or RSX\README.TXT (Windows 3.1). The runtime packages themselves
                     31:   are in GPRT.ZIP.
                     32:
                     33: 2) PostScript Documentation (GPD): GPD_xxxx.ZIP
                     34:   user's manual, tutorial and reference card, in PostScript format
                     35:
                     36: 3) TeX Documentation (GPM): GPM_xxxx.ZIP
                     37:   in (hopefully human readable) TeX format
                     38:   Also contains the script GPHELP (translates Pari documentation
                     39:   to plain text, handles indexing), which requires Perl (not included).
                     40:   You may have to fix paths in the first lines of the script.
                     41: -----------------------------------------------------------------------------
                     42: 4) EMX/RSX runtime package (GPRT): GPRT.ZIP
                     43:   files you will need if the provided binary GP.EXE doesn't work as is.
                     44:
                     45: 5) Readline (GPRL): GPRL.ZIP
                     46:   source of the _modified_ readline library used to compile GP.EXE
                     47:
                     48: The files can be extracted using UNZIP or PKUNZIP -D (don't forget the -D)
                     49: ===========================================================================
                     50:
                     51: II: What do I need ? (X = required, [X] = optional)
                     52: --------------------
                     53:
                     54:     To run GP |  To compile libpari | To compile GP
                     55:               |                     |
                     56: GPB      X    |                     |
                     57: GPD     [X]   |                     |
                     58: GPM     [X]   |                     |
                     59: GPRT     X    |                     |
                     60: GPRL          |                     |       X
                     61: sources       |           X         |       X
                     62: galdata [X]   |                     |
                     63:
                     64: 'sources' refers to the generic Unix distribution archive (pari.tgz).
                     65: 'galdata' is the file galdata.tgz which can be found at the same place as
                     66: pari.tgz. It is only needed to compute the Galois group of polynomials of
                     67: degree 8 to 11 (higher degrees not implemented).
                     68:
                     69: ===========================================================================
                     70:
                     71: III: What do I do with it ?
                     72:
                     73:   1) I only want to use GP.EXE
                     74:
                     75: * For DOS: install EMX.EXE from GPRT somewhere in your path.  If you have
                     76: enough RAM (~ 2MB), you can run GP.EXE as is, but some functionalities
                     77: (extended help, external commands) will only be available if you use the
                     78: command line EMX -P GP.EXE [put that in a GP.BAT file, or (preferably)
                     79: fetch a decent shell (e.g. bash) and use an alias].
                     80:
                     81: * For Windows 3.1: install RSX.EXE and CSX.EXE from GPRT somewhere in your
                     82: path. Not thoroughly tested; looks ok, though.
                     83:
                     84: * For OS/2: untested. You may need EMX.DLL from GPRT.
                     85:
                     86: If you want to use the polgalois function for polynomials of degree 8 to
                     87: 11, fetch galdata.tgz and extract it in \pari\data (can't be customized
                     88: without recompiling).
                     89:
                     90:   2) I want to build the PARI library for my own C programs
                     91:
                     92: You need the _complete_ EMX package (not the runtime files we provide) and a
                     93: make utility (see EMX\README.DOC; dmake and GNU make are both ok).
                     94:
                     95: Fetch the Unix source distribution (tar and basic shell utilities needed to
                     96: extract it). Then, from the distribution top directory:
                     97:
                     98:   cd Odos
                     99:   make lib
                    100:
                    101:   3) I also want to recompile GP.EXE
                    102:
                    103: You need the GPRL archive (extract it from the distribution top directory).
                    104:
                    105:   cd readline
                    106:   dmake
                    107:   cd ..
                    108:   cd Odos
                    109:   dmake     [if you don't have dmake, comment out the .IF constructs in
                    110:              Makefile. Otherwise, type "dmake DBG=1" for a debugging version]
                    111:
                    112:   4) I want to run the benches
                    113:
                    114: Build GP.EXE first (or extract the binary from GPB and put it in the 'Odos'
                    115: subdirectory), then type
                    116:
                    117:   cd Odos
                    118:   ..\src\test\dotest
                    119:
                    120: (decent shell and basic Unix tools needed: the djgpp ports of bash and GNU
                    121: binutils work nicely, Ian Stewartson's tools are also ok). Make sure FILES
                    122: is at least 50 in CONFIG.SYS