Return to README.DOS CVS log

Up to [local] / OpenXM_contrib / pari-2.2

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

1.1     ! noro        1: PARI/GP is developped and tested in the Unix world, but has been partly
        !             2: ported to DOS/Windows using the EMX/RSX runtime packages. The resulting
        !             3: binary GP.EXE should be usable on most DOS-based platforms, although it won't
        !             4: share the traditional look and feel of e.g native Windows programs. Binaries
        !             5: may or may not be available after each Unix release.
        !             6:
        !             7: Everything written in this file applies to DOS 3.0 or higher, OS/2 2.0 or
        !             8: higher, and Windows 3.1. An 80386 CPU or higher is required in any case.
        !             9:
        !            10: See README.WIN for more recent versions of Windows (95 or higher).
        !            11: %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
        !            12:
        !            13: I: What's in there ?
        !            14: --------------------
        !            15:
        !            16: The DOS archive is divided in 4 parts: the first 2 (GPB, GPD) change each
        !            17: time an update is made, the last two (GPRT, GPRL) need only be downloaded
        !            18: once, if at all. The complete sources are distributed in the Unix version,
        !            19: but are not required unless you want to compile GP or the PARI library
        !            20: yourself.
        !            21:
        !            22: xxxx stands for a version number
        !            23:
        !            24: 1) Binary (GPB): GPB_xxxx.ZIP
        !            25:   + GP.EXE binary, linked with GNU readline
        !            26:   + various README files
        !            27:
        !            28:   GP.EXE is an EMX executable; it it doesn't start up, check EMX\EMXRT.DOC
        !            29:   (DOS, OS/2) or RSX\README.TXT (Windows). The runtime packages themselves
        !            30:   are in GPRT.ZIP. Note that GP.EXE is twice slower than a native Linux binary.
        !            31:
        !            32: 2) Documentation and Examples (GPD): GPD_xxxx.ZIP, containing the directories
        !            33:   + DOC, containing
        !            34:      - user's manual, tutorial and reference card in TeX format You wil
        !            35:        need TeX to compile them (see www.CTAN.org for how to get TeX) The
        !            36:        same documents are available in PDF and PostScript format from
        !            37:
        !            38:          ftp://megrez.math.u-bordeaux.fr/pub/pari/manuals/
        !            39:
        !            40:      - the script GPHELP (translates Pari documentation to plain text and
        !            41:        handles "apropos help"), which requires PERL (see www.CPAN.org for how
        !            42:        to get it). You may have to fix paths in the first lines of the script.
        !            43:        Set your GPRC file so that the 'help' default points to the place where
        !            44:        you deposit GPHELP (see MISC/GPRC.DOS).
        !            45:
        !            46:   + MISC, containing
        !            47:       - a sample GPRC file (GPRC.DOS). Copy it to C:\_GPRC (or \etc\GPRC) and
        !            48:         adapt it to your needs
        !            49:       - a sample alias file (GPALIAS).
        !            50:
        !            51:   + EXAMPLES, containing sample GP scripts
        !            52:
        !            53:
        !            54: 3) EMX/RSX runtime package (GPRT): GPRT.ZIP
        !            55:   files you will need if the provided binary GP.EXE doesn't work as is.
        !            56:
        !            57: 4) Readline (GPRL): GPRL.ZIP
        !            58:   source of the modified readline library (version 1.0) used to compile GP.EXE
        !            59:
        !            60: The files can be extracted using UNZIP or PKUNZIP -D (don't forget the -D).
        !            61: Depending on what you want to do, the files you need are (X = required, [X] =
        !            62: optional)
        !            63:
        !            64:     To run GP |  To compile libpari | To compile GP
        !            65:               |                     |
        !            66: GPB      X    |                     |
        !            67: GPD     [X]   |                     |
        !            68: GPRT     X    |                     |
        !            69: GPRL          |                     |       X
        !            70: sources       |           X         |       X
        !            71: galdata [X]   |                     |
        !            72:
        !            73: 'sources' refers to the generic Unix distribution archive (pari.tgz).
        !            74: 'galdata' is the file galdata.tgz which can be found at the same place as
        !            75: pari.tgz. It is only needed to compute the Galois group of polynomials of
        !            76: degree 8 to 11 (higher degrees not implemented).
        !            77:
        !            78: %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
        !            79:
        !            80: II: What do I do with it ?
        !            81: --------------------------
        !            82:   1) I only want to use GP.EXE
        !            83:
        !            84: * For DOS: install EMX.EXE from GPRT somewhere in your path.  If you have
        !            85: enough RAM (~ 2MB), you can run GP.EXE as is, but some functionalities
        !            86: (extended help, external commands) will only be available if you use the
        !            87: command line EMX -P GP.EXE. Put that in a GP.BAT file, or (preferably)
        !            88: fetch a decent shell (e.g. bash) and use an alias.
        !            89:
        !            90: * For Windows: install RSX.EXE from GPRT somewhere in your path.
        !            91:
        !            92: * For OS/2: untested. You may need EMX.DLL from GPRT.
        !            93:
        !            94: In all cases, if you want to use the polgalois function for polynomials of
        !            95: degree 8 to 11, fetch galdata.tgz and extract it in \pari\data (can't be
        !            96: customized without recompiling).
        !            97:
        !            98:   2) I want to build the PARI library for my own C programs
        !            99:
        !           100: You need the _complete_ EMX package (not the runtime files we provide) and a
        !           101: make utility (see EMX\README.DOC; dmake and GNU make are both ok).
        !           102:
        !           103: Fetch the Unix source distribution (tar and basic shell utilities needed to
        !           104: extract it). Then, from the distribution top directory:
        !           105:
        !           106:   cd Odos
        !           107:   make lib
        !           108:
        !           109:   3) I also want to recompile GP.EXE
        !           110:
        !           111: You need the GPRL archive (extract it from the distribution top directory).
        !           112:
        !           113:   cd readline
        !           114:   dmake
        !           115:   cd ..
        !           116:   cd Odos
        !           117:   dmake
        !           118:
        !           119:   4) I want to run the benches
        !           120:
        !           121: Build GP.EXE first (or extract the binary from GPB and put it in the 'Odos'
        !           122: subdirectory), then type
        !           123:
        !           124:   cd Odos
        !           125:   ..\src\test\dotest
        !           126:
        !           127: (decent shell and basic Unix tools needed: the djgpp ports of bash and GNU
        !           128: binutils work nicely, Ian Stewartson's tools are also ok). Make sure FILES
        !           129: is at least 50 in CONFIG.SYS. Bash and sh may run out of memory during the
        !           130: bench.