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
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>