Return to README.DOS CVS log

Up to [local] / OpenXM_contrib / pari

Annotation of OpenXM_contrib/pari/README.DOS, Revision 1.1

1.1     ! maekawa     1: PARI/GP is developped and tested in the Unix world. Since sticking to Unix
        !             2: would prevent many users from enjoying the system [not everybody wants to
        !             3: install Linux], PARI has been (partly) ported to DOS using the EMX runtime
        !             4: package. The resulting binary GP.EXE should be usable on most DOS-based
        !             5: platforms, although it won't share the traditional look and feel of e.g
        !             6: native Windows programs. Binaries may or may not be available after each
        !             7: Unix release.
        !             8:
        !             9: Everything written in this file applies to DOS 3.0 or higher, OS/2 2.0 and
        !            10: higher, and Windows 3.1 (unless noted otherwise). It seems that GP.EXE runs
        !            11: more or less correctly in a DOS window under Windows 95/98/NT, but this has
        !            12: not been extensively tested. An 80386 CPU or higher is required in any case.
        !            13: =============================================================================
        !            14:
        !            15: I: What's in there ?
        !            16: --------------------
        !            17:
        !            18: The DOS archive is divided in 5 parts: the first 3 will change each time an
        !            19: update is made (xxxx stands for a version number), the last two need only be
        !            20: downloaded once, if at all. The complete sources are distributed in the Unix
        !            21: version, but are not required unless you want to compile GP or the PARI
        !            22: library yourself.
        !            23:
        !            24: 1) Binaries (GPB): GPB_xxxx.ZIP
        !            25:   + GP.EXE binary, linked with GNU readline
        !            26:   + an EXAMPLES directory, containing sample GP scripts and a GPRC file
        !            27:     (copy the latter to C:\_GPRC and adapt it to your needs)
        !            28:
        !            29:   GP.EXE is an EMX executable; it it doesn't start up, check EMX\EMXRT.DOC
        !            30:   (DOS, OS/2) or RSX\README.TXT (Windows 3.1). The runtime packages themselves
        !            31:   are in GPRT.ZIP.
        !            32:
        !            33: 2) PostScript Documentation (GPD): GPD_xxxx.ZIP
        !            34:   user's manual, tutorial and reference card, in PostScript format
        !            35:
        !            36: 3) TeX Documentation (GPM): GPM_xxxx.ZIP
        !            37:   in (hopefully human readable) TeX format
        !            38:   Also contains the script GPHELP (translates Pari documentation
        !            39:   to plain text, handles indexing), which requires Perl (not included).
        !            40:   You may have to fix paths in the first lines of the script.
        !            41: -----------------------------------------------------------------------------
        !            42: 4) EMX/RSX runtime package (GPRT): GPRT.ZIP
        !            43:   files you will need if the provided binary GP.EXE doesn't work as is.
        !            44:
        !            45: 5) Readline (GPRL): GPRL.ZIP
        !            46:   source of the _modified_ readline library used to compile GP.EXE
        !            47:
        !            48: The files can be extracted using UNZIP or PKUNZIP -D (don't forget the -D)
        !            49: ===========================================================================
        !            50:
        !            51: II: What do I need ? (X = required, [X] = optional)
        !            52: --------------------
        !            53:
        !            54:     To run GP |  To compile libpari | To compile GP
        !            55:               |                     |
        !            56: GPB      X    |                     |
        !            57: GPD     [X]   |                     |
        !            58: GPM     [X]   |                     |
        !            59: GPRT     X    |                     |
        !            60: GPRL          |                     |       X
        !            61: sources       |           X         |       X
        !            62: galdata [X]   |                     |
        !            63:
        !            64: 'sources' refers to the generic Unix distribution archive (pari.tgz).
        !            65: 'galdata' is the file galdata.tgz which can be found at the same place as
        !            66: pari.tgz. It is only needed to compute the Galois group of polynomials of
        !            67: degree 8 to 11 (higher degrees not implemented).
        !            68:
        !            69: ===========================================================================
        !            70:
        !            71: III: What do I do with it ?
        !            72:
        !            73:   1) I only want to use GP.EXE
        !            74:
        !            75: * For DOS: install EMX.EXE from GPRT somewhere in your path.  If you have
        !            76: enough RAM (~ 2MB), you can run GP.EXE as is, but some functionalities
        !            77: (extended help, external commands) will only be available if you use the
        !            78: command line EMX -P GP.EXE [put that in a GP.BAT file, or (preferably)
        !            79: fetch a decent shell (e.g. bash) and use an alias].
        !            80:
        !            81: * For Windows 3.1: install RSX.EXE and CSX.EXE from GPRT somewhere in your
        !            82: path. Not thoroughly tested; looks ok, though.
        !            83:
        !            84: * For OS/2: untested. You may need EMX.DLL from GPRT.
        !            85:
        !            86: If you want to use the polgalois function for polynomials of degree 8 to
        !            87: 11, fetch galdata.tgz and extract it in \pari\data (can't be customized
        !            88: without recompiling).
        !            89:
        !            90:   2) I want to build the PARI library for my own C programs
        !            91:
        !            92: You need the _complete_ EMX package (not the runtime files we provide) and a
        !            93: make utility (see EMX\README.DOC; dmake and GNU make are both ok).
        !            94:
        !            95: Fetch the Unix source distribution (tar and basic shell utilities needed to
        !            96: extract it). Then, from the distribution top directory:
        !            97:
        !            98:   cd Odos
        !            99:   make lib
        !           100:
        !           101:   3) I also want to recompile GP.EXE
        !           102:
        !           103: You need the GPRL archive (extract it from the distribution top directory).
        !           104:
        !           105:   cd readline
        !           106:   dmake
        !           107:   cd ..
        !           108:   cd Odos
        !           109:   dmake     [if you don't have dmake, comment out the .IF constructs in
        !           110:              Makefile. Otherwise, type "dmake DBG=1" for a debugging version]
        !           111:
        !           112:   4) I want to run the benches
        !           113:
        !           114: Build GP.EXE first (or extract the binary from GPB and put it in the 'Odos'
        !           115: subdirectory), then type
        !           116:
        !           117:   cd Odos
        !           118:   ..\src\test\dotest
        !           119:
        !           120: (decent shell and basic Unix tools needed: the djgpp ports of bash and GNU
        !           121: binutils work nicely, Ian Stewartson's tools are also ok). Make sure FILES
        !           122: is at least 50 in CONFIG.SYS