[BACK]Return to README.WIN CVS log [TXT][DIR] Up to [local] / OpenXM_contrib / pari-2.2

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>