Return to README.WIN CVS log

Up to [local] / OpenXM_contrib / pari-2.2

Annotation of OpenXM_contrib/pari-2.2/README.WIN, Revision 1.2

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
1.2     ! noro        6: distributions. Dual boot systems (LILO, Grub) enable you to have Windows and
        !             7: Linux coexisting peacefully on your hard drive, so you can have the best of
        !             8: both worlds. The other solutions stick to the Windows environment, suffer
        !             9: from various problems, and are discussed in the rest of this document.
1.1       noro       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:
1.2     ! noro       50:   ftp://megrez.math.u-bordeaux.fr/pub/pari/windows/cygwin1.dll.gz
1.1       noro       51:
                     52: (size: 268k, 600k uncompressed). It needs to be downloaded only once.
                     53: Then fetch the GP binary
                     54:
1.2     ! noro       55:   ftp://megrez.math.u-bordeaux.fr/pub/pari/windows/gp-xxx.exe.gz
1.1       noro       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:
1.2     ! noro       64: NOTE: if you're interested in a Unix-style development environment under
        !            65: Windows, you might wish to download the full cygwin distribution from
        !            66:   http://sources.redhat.com/cygwin/
        !            67: You will then be able to build GP from the generic (unix) sources [ using the
        !            68: standard './Configure; make' idiom ]
1.1       noro       69:
1.2     ! noro       70: %%%%%%%%%%%%%  Solution 2: Build GP from sources   %%%%%%%%%%%%%%%%%%%
1.1       noro       71:
                     72: That is, the generic Unix sources
                     73:
                     74:   ftp://megrez.math.u-bordeaux.fr/pub/pari/pari.tgz
                     75:
                     76: It is quite easy to build (or cross-build) GP and readline from the unix
                     77: sources using mingw, but if you have installed mingw you probably also have
                     78: Cygwin, in which case it's even easier to use the generic build process as
                     79: under Unix, as mentioned in Solution 1. IMPORTANT NOTE: you have to type
                     80: "make gp-sta" since Configure defaults to building the dynamic version, which
                     81: doesn't work (see below) [this is a bug in Configure].
                     82:
                     83: So I'm assuming from now on that you're stuck with something which is not
                     84: gcc. If you have MSVC, then check Odos/README.MSVC in the archive which
                     85: explains in detail all steps involved. If you have some other compiler, and
                     86: succeed in compiling GP, we'd be quite happy to hear from you.
                     87:
                     88: PROBLEMS:
                     89:   * no hi-res plots, most graphics commands disabled (you can still output to
                     90:     a PostScript file).
                     91:
1.2     ! noro       92:   * slower than gcc-compiled binaries.
1.1       noro       93:
                     94:   * no extended on-line help
                     95:
                     96:   * no line-editing facilities (GP not linked with readline).
                     97:
                     98: %%%%%%%%%%%%%  What about library programming ? %%%%%%%%%%%%%%%%%%%%%%
                     99:
                    100: Building a static LIBPARI.A Library should be straightforward. It is possible
                    101: but painful to build a LIBPARI.DLL and .def file using gcc-mingw (or
                    102: gcc-cygwin) + dlltool and some header magic; but GP itself, when linked with
                    103: such a library, crashes on startup.  No other decent compiler being available
                    104: to us, we won't provide prebuilt libraries. For this one, you're on your own.
                    105: Sorry.