Annotation of OpenXM_contrib/pari-2.2/README.WIN, Revision 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>