Annotation of OpenXM_contrib/pari/doc/gp.1, Revision 1.1
1.1 ! maekawa 1: .TH GP 1 "25 June 1999"
! 2: .SH NAME
! 3: gp \- PARI calculator
! 4: .SH SYNOPSIS
! 5: .B gp
! 6: .RB [ -emacs ]
! 7: .RB [ -f ]
! 8: .RB [ -test ]
! 9: .RB [ -q ]
! 10: .RB [ -s
! 11: .IR stacksize ]
! 12: .RB [ -p
! 13: .IR primelimit ]
! 14:
! 15: .SH DESCRIPTION
! 16: Invokes the PARI-GP calculator. This is an advanced programmable calculator,
! 17: which computes symbolically as long as possible, numerically where needed,
! 18: and contains a wealth of number-theoretic functions (elliptic curves, class
! 19: field theory...). Its basic data types are
! 20: .TP
! 21: numbers
! 22: integers, real numbers, exact rational numbers, algebraic numbers,
! 23: .BR p "-adic numbers,"
! 24: complex numbers,
! 25: .TP
! 26: modular integers
! 27: integers modulo
! 28: .BR n ,
! 29: .TP
! 30: polynomials
! 31: and rational functions,
! 32: .TP
! 33: power series,
! 34: .TP
! 35: binary quadratic forms,
! 36: .TP
! 37: matrices, vectors,
! 38: and lists,
! 39: .TP
! 40: character strings,
! 41: .PP
! 42: and recursive combinations of these.
! 43:
! 44: .SH OPTIONS
! 45: The following command line options are available:
! 46: .TP
! 47: .B \-emacs
! 48: GP can be run in an
! 49: .I Emacs
! 50: shell (see GP User's manual for details). This flag is then required for
! 51: smooth interaction with the relevant
! 52: .I Emacs
! 53: package (pari.el). It is set automatically by the pari.el package, and will
! 54: produce nice display oddities if you set it outside of an
! 55: .I Emacs
! 56: session.
! 57: .TP
! 58: .B \-f
! 59: Fast start (or factory settings). Do not read
! 60: .B .gprc
! 61: (see below) upon startup.
! 62: .TP
! 63: .B \-q
! 64: Quiet mode. Don't print headers or history numbers, don't say goodbye.
! 65: .TP
! 66: .BI \-p " primelimit"
! 67: Upon startup, GP computes a table of small primes used in most
! 68: number-theoretic applications. If
! 69: .I primelimit
! 70: is set here, include primes up to that bound instead of the default.
! 71: Unreasonably high values will considerably increase startup time. Exceedingly
! 72: small values will cause some number-theoretic functions to fail with the
! 73: message "not enough precomputed primes".
! 74: .TP
! 75: .BI \-s " stacksize"
! 76: Size of GP internal stack. The stack is increased from within GP
! 77: in case of need but might interrupt an important computation.
! 78: If your machine can stand it, start with a bigger stack (especially if you
! 79: make heavy use of linear algebra). Not that computations with a
! 80: .B smaller
! 81: stack may be more efficient due to better data locality. Sensible
! 82: computations should need less than 20MB.
! 83: .TP
! 84: .B \-test
! 85: run GP in test mode: suppress printing of history numbers and wrap long
! 86: output lines (to get readable diff output). For benches only.
! 87: .SH USE
! 88: .TP
! 89: .B ?
! 90: to get online help.
! 91: .TP
! 92: .B ??
! 93: to get extended online help (more precisely, to call the external help
! 94: program,
! 95: .B gphelp
! 96: by default)
! 97: .TP
! 98: .B quit
! 99: (or \\q), or
! 100: .B EOF
! 101: (Ctrl-D) to quit
! 102: .BR gp .
! 103: .PP
! 104: The following works only when gp was linked with GNU
! 105: .IR readline
! 106: library:
! 107: .TP
! 108: arrow keys
! 109: for editing and viewing the input history.
! 110: .TP
! 111: .B TAB
! 112: for automatic completion
! 113:
! 114: .SH MANUALS
! 115: The following material is included in the standard distribution (originally
! 116: in TeX format):
! 117: .TP
! 118: .I The PARI/GP Users's Manual
! 119: (users.dvi)
! 120: .TP
! 121: .I PARI/GP, a tutorial
! 122: (tutorial.dvi): not yet completed but still useful.
! 123: .TP
! 124: .I PARI/GP reference card
! 125: (refcard.ps): 4 pages, based on an earlier version by Joseph H. Silverman.
! 126: .TP
! 127: .I pariemacs.txt
! 128: explains the use of the pari.el package, and how to customize it (prompt,
! 129: colors).
! 130:
! 131: .SH FILES
! 132: .TP
! 133: .I gp
! 134: main executable
! 135: .TP
! 136: .I $HOME/.gprc
! 137: (or $GPRC if set) read at beginning of execution by each
! 138: .B gp
! 139: shell. A default gprc
! 140: .I gprc.dft
! 141: is provided with the distribution. If this file cannot be found,
! 142: .I /etc/gprc
! 143: is checked instead.
! 144: .TP
! 145: .I pari.log
! 146: default logfile (can be changed in
! 147: .I .gprc
! 148: or interactively using
! 149: .B default()
! 150: )
! 151: .TP
! 152: .I pari.ps
! 153: default psfile used for postscript output (as above)
! 154: .TP
! 155: .I /usr/local/bin/gphelp
! 156: default external help program (as above)
! 157: .TP
! 158: .I /usr/local/lib/pari/pari.el
! 159: elisp package to run pari in an
! 160: .I Emacs
! 161: shell. Must be loaded from your
! 162: .I .emacs
! 163: file.
! 164: .TP
! 165: .I *.gp
! 166: gp programs
! 167:
! 168: .SH PRIMARY FTP SITE
! 169: The most recent distributions can be found at
! 170: .RS
! 171: .I ftp://megrez.math.u-bordeaux.fr/pub/pari
! 172: .RE
! 173:
! 174: Tips, development info, nice icons and bad jokes can be found at
! 175: PARI home page, set up by Gerhard Niklasch at
! 176: .RS
! 177: .I http://hasse.mathematik.tu-muenchen.de/ntsw/pari/
! 178: .RE
! 179:
! 180: .SH MAILING LISTS
! 181: There are three mailing lists devoted to the PARI/GP package (run courtesy
! 182: of Dan Bernstein), and most feedback should be directed to those. They are:
! 183:
! 184: .PP
! 185: -
! 186: .B pari-announce
! 187: (moderated): for us to announce major version changes.
! 188: .PP
! 189: -
! 190: .B pari-dev:
! 191: for everything related to the development of PARI, including
! 192: suggestions, technical questions, bug reports or patch submissions.
! 193:
! 194: .PP
! 195: -
! 196: .B pari-users:
! 197: for everything else.
! 198:
! 199: To subscribe, send empty messages respectively to
! 200:
! 201: .PP
! 202: pari-announce-subscribe@list.cr.yp.to
! 203: .PP
! 204: pari-users-subscribe@list.cr.yp.to
! 205: .PP
! 206: pari-dev-subscribe@list.cr.yp.to
! 207:
! 208: .SH BUG REPORTS
! 209: If you find a bug, you should report it. But first make sure that it really
! 210: is a bug and that it appears in the latest version of
! 211: .B gp
! 212: that you have. Then you can actually mail your bug report (make it short
! 213: and easily reproducible if possible), including the header
! 214: .B gp
! 215: displays on startup, to the
! 216: .IR pari-dev
! 217: mailing list (preferably) or to
! 218: .IR pari@math.u-bordeaux.fr .
! 219: Fixes are welcome too !
! 220:
! 221: .SH TRIVIA
! 222: Despite the leading G, GP has nothing to do with GNU. The first version was
! 223: originally called GPC, for Great Programmable Calculator. For some reason,
! 224: the trailing C was eventually dropped.
! 225:
! 226: PARI has nothing to do with the French capital. The name just stuck when
! 227: the authors started to implement the system in Pascal (they quickly
! 228: switched to C).
! 229:
! 230: For the benefit of non-native French speakers, here's a slightly expanded
! 231: explanation:
! 232: .B Blaise Pascal
! 233: (1623-1662) was a famous French mathematician and philosopher who was one
! 234: of the founders of probability and devised one of the first "arithmetic
! 235: machines". He once proposed the following "proof" of the existence of God
! 236: for the unbelievers: whether He exists or not I lose nothing by believing
! 237: in Him, whereas if He does and I misbehave... This is the so-called "pari
! 238: de Pascal" (Pascal's bet).
! 239:
! 240: Note that PARI also means "fairy" in Persian.
! 241:
! 242: .SH AUTHORS
! 243: PARI was originally written by Christian Batut, Dominique Bernardi, Henri
! 244: Cohen, and Michel Olivier in Laboratoire A2X (Universite Bordeaux I,
! 245: France), and was maintained by Henri Cohen up to version 1.39.15. Karim
! 246: Belabas did the rewrite leading to version 2.0 and is the current
! 247: maintainer.
! 248:
! 249: A great number of people have contributed to the successive improvements
! 250: which eventually resulted in the present version. See the AUTHORS file in
! 251: the distribution.
! 252:
! 253: .SH SEE ALSO
! 254: .IR dvips (1),
! 255: .IR emacs (1),
! 256: .IR gap (1),
! 257: .IR ghostview (1),
! 258: .IR gphelp (1),
! 259: .IR maple (1),
! 260: .IR perl (1),
! 261: .IR readline (3),
! 262: .IR tex (1),
! 263: .IR xdvi(1)
! 264:
! 265: .SH COPYING
! 266: gp and PARI are Copyright (C) 1989-1999 by C.Batut, K.Belabas, D.Bernardi,
! 267: H.Cohen and M.Olivier.
! 268:
! 269: This software is intended as a service to the scientific community, but the
! 270: authors cannot be held responsible for any consequences, either direct or
! 271: indirect, which the use of this package may have. It can be freely copied
! 272: and spread for non commercial purposes, as long as no files are modified,
! 273: and that the whole package (source and manual) is included.
! 274:
! 275: Individual code modules included in the package may come with their own
! 276: copyright and license conditions. See the COPYRIGHT file in the
! 277: distribution.
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>