Annotation of OpenXM_contrib/pari/README.DOS, Revision 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
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>