Annotation of OpenXM_contrib/pari-2.2/README.WIN, Revision 1.1.1.1
1.1 noro 1: This file describes the various ways you can run PARI/GP in a win32 environment
2: (Windows 95,98,2000,NT). For earlier versions of Windows, see README.DOS.
3:
4: WARNING: The only way to have a fully functional GP is to install GNU/Linux.
5: It's a one hour job to install a minimal Linux system from current Linux
6: distributions. The LILO boot system enables you to have Windows and Linux
7: coexisting peacefully on your hard drive, so you can have the best of both
8: worlds. The other solutions all stick to the Windows environment, suffer from
9: various problems, and are discussed in the rest of this document.
10:
11: It is also advised, but not mandatory to get the Documentation and Examples
12: archive
13:
14: ftp://megrez.math.u-bordeaux.fr/pub/pari/dos/GPDxxx.ZIP
15:
16: which contains the following directories:
17:
18: + DOC, containing
19: - user's manual, tutorial and reference card in TeX format You will
20: need TeX to compile them (see www.CTAN.org for how to get TeX). The
21: same documents are available in PDF and PostScript format from
22:
23: ftp://megrez.math.u-bordeaux.fr/pub/pari/manuals/
24:
25: (and so is the "readline" reference manual if you use one of the
26: solutions providing line editing)
27:
28: - the script GPHELP (translates Pari documentation to plain text and
29: handles "apropos help"), which requires PERL (see www.CPAN.org for how
30: to get it). You may have to fix paths in the first lines of the script.
31: Set your GPRC file so that the 'help' default points to the place where
32: you deposit GPHELP (see MISC/GPRC.DOS).
33:
34: + MISC, containing
35: - a sample GPRC file (GPRC.DOS). Copy it to C:\_GPRC (or \etc\GPRC) and
36: adapt it to your needs
37: - a sample alias file (GPALIAS).
38:
39: + EXAMPLES, containing sample GP scripts, and a sample INPUTRC file (for
40: readline, you can use it to customize GP line editing).
41:
42: NOTE: all .gz and .ZIP files are compressed files (or archives). Extract them
43: [ with Winzip (see www.winzip.com) for instance ] once you have downloaded them.
44:
45: %%%%%%%%%%%%% Solution 1: The CYGWIN library %%%%%%%%%%%%%%%%%%%%%%%%
46:
47: This is the preferred solution, but it requires fetching the cygwin
48: compatibility library first. We provide this file as
49:
50: ftp://megrez.math.u-bordeaux.fr/pub/pari/windows/cygwin/cygwin1.dll.gz
51:
52: (size: 268k, 600k uncompressed). It needs to be downloaded only once.
53: Then fetch the GP binary
54:
55: ftp://megrez.math.u-bordeaux.fr/pub/pari/windows/cygwin/gp-xxx.exe.gz
56:
57: and put it in the same directory as the dll (or dump the dll somewhere in
58: your PATH, as you prefer).
59:
60: PROBLEMS:
61: * no hi-res plots, most graphics commands disabled (you can still output to
62: a PostScript file)
63:
64: NOTE: you might wish to download the full cygwin distribution from
65: http://sources.redhat.com/cygwin/ [ the Download and Installation process is
66: automated and quite simple, you should be home in a few mouse clicks...
67: provided your internet connection is good enough. ]. It provides a neat
68: gcc-based development environment under Windows, under which most Unix
69: packages can easily be ported. In particular you will be able to build GP
70: from the generic (unix) sources.
71:
72:
73: %%%%%%%%%%%%% Solution 2: The native (mingw) binary %%%%%%%%%%%%%%%%%
74:
75: Fetch the GP binary (cross-compiled using the gcc-mingw compiler):
76: EITHER
77:
78: ftp://megrez.math.u-bordeaux.fr/pub/pari/windows/gp-xxx.exe.gz
79: (includes readline line-editing, history, keyword completion, facilities)
80:
81: OR
82:
83: ftp://megrez.math.u-bordeaux.fr/pub/pari/windows/gp-norl-xxx.exe.gz
84: (doesn't include readline).
85:
86: PROBLEMS:
87: * no hi-res plots, most graphics commands disabled (you can still output to
88: a PostScript file)
89:
90: * doesn't work well when started in a console from a MS-DOS shell:
91: - on ^C gp quits
92: - redirecting standard input as in 'gp < file' crashes gp
93:
94: SOLUTION: None of these things occur if you start gp by double-clicking
95: on its icon, as is customary for Windows application. ^C still doesn't
96: always interrupt computations, but at least it doesn't kill gp.
97:
98: * colors don't work (escape sequences printed "as is").
99:
100: * no extended on-line help
101:
102: * [readline binary only]: the AltGr key doesn't work. If you have a US
103: keyboard, you don't care. But if you have, e.g a French keyboard, you
104: won't be able to produce {}, [], \, ...
105:
106: SOLUTION:
107: create an INPUTRC file for readline (cf user's manual or readline
108: manual). E.g add a line
109:
110: set INPUTRC=C:\INPUTRC.txt (for instance).
111:
112: to your AUTOEXEC.BAT. Then create this file, and add lines of the form
113:
114: "\M-\\": "\\" (\M stands for ALT or META, \C for CONTROL)
115: "\M-\[": "["
116:
117: etc... This binds (for readline purposes only, doesn't affect regular
118: Windows operations) the key sequence on the LHS, to some "meaning" on the
119: RHS, here an ordinary character. E.g inserting a line
120:
121: "a": "b"
122:
123: will cause GP to insert a "b" when you type an "a". Depending on your
124: precise keyboard layout, you may have to fiddle a bit with the keyseq and
125: replacement text before getting something sensible.
126:
127: %%%%%%%%%%%%% Solution 3: The RSX runtime package %%%%%%%%%%%%%%%%%%%
128:
129: You can use the GP binary from the archive
130:
131: ftp://megrez.math.u-bordeaux.fr/pub/pari/dos/GPBxxx.ZIP
132:
133: PROBLEMS:
134: * no hi-res plots, most graphics commands disabled (you can still output to
135: a PostScript file).
136:
137: * more than twice SLOWER than all the other binaries described here.
138:
139: %%%%%%%%%%%%% Solution 4: Build GP from sources %%%%%%%%%%%%%%%%%%%
140:
141: That is, the generic Unix sources
142:
143: ftp://megrez.math.u-bordeaux.fr/pub/pari/pari.tgz
144:
145: It is quite easy to build (or cross-build) GP and readline from the unix
146: sources using mingw, but if you have installed mingw you probably also have
147: Cygwin, in which case it's even easier to use the generic build process as
148: under Unix, as mentioned in Solution 1. IMPORTANT NOTE: you have to type
149: "make gp-sta" since Configure defaults to building the dynamic version, which
150: doesn't work (see below) [this is a bug in Configure].
151:
152: So I'm assuming from now on that you're stuck with something which is not
153: gcc. If you have MSVC, then check Odos/README.MSVC in the archive which
154: explains in detail all steps involved. If you have some other compiler, and
155: succeed in compiling GP, we'd be quite happy to hear from you.
156:
157: PROBLEMS:
158: * no hi-res plots, most graphics commands disabled (you can still output to
159: a PostScript file).
160:
161: * slower than all gcc-compiled binaries (faster than RSX version though).
162:
163: * no extended on-line help
164:
165: * no line-editing facilities (GP not linked with readline).
166:
167: %%%%%%%%%%%%% What about library programming ? %%%%%%%%%%%%%%%%%%%%%%
168:
169: Building a static LIBPARI.A Library should be straightforward. It is possible
170: but painful to build a LIBPARI.DLL and .def file using gcc-mingw (or
171: gcc-cygwin) + dlltool and some header magic; but GP itself, when linked with
172: such a library, crashes on startup. No other decent compiler being available
173: to us, we won't provide prebuilt libraries. For this one, you're on your own.
174: Sorry.
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>