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