Annotation of OpenXM_contrib/pari-2.2/doc/gp.1, Revision 1.1
1.1 ! noro 1: .TH GP 1 "28 August 2001"
! 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. GP 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: A numeric argument to the following options can be followed by a
! 46: .B k
! 47: or a
! 48: .B M
! 49: at the user's convenience. In that case the argument is multiplied by 1000
! 50: or 1000000 respectively. The following command line options are available:
! 51: .TP
! 52: .B \-emacs
! 53: GP can be run in an
! 54: .I Emacs
! 55: shell (see GP User's manual for details). This flag is then required for
! 56: smooth interaction with the relevant
! 57: .I Emacs
! 58: package (pari.el). It is set automatically by the pari.el package, and will
! 59: produce nice display oddities if you set it outside of an
! 60: .I Emacs
! 61: session.
! 62: .TP
! 63: .B \-f
! 64: Fast start (or factory settings). Do not read
! 65: .B .gprc
! 66: (see below) upon startup.
! 67: .TP
! 68: .B \-q
! 69: Quiet mode. Don't print headers or history numbers, don't say goodbye.
! 70: .TP
! 71: .BI \-p " primelimit"
! 72: Upon startup, GP computes a table of small primes used in most
! 73: number-theoretic applications. If
! 74: .I primelimit
! 75: is set here, include primes up to that bound instead of the default.
! 76: Unreasonably high values will considerably increase startup time. Exceedingly
! 77: small values will cause some number-theoretic functions to fail with the
! 78: message "not enough precomputed primes".
! 79: .TP
! 80: .BI \-s " stacksize"
! 81: Size of GP internal stack allocated on startup. When GP runs out of space, it
! 82: interrupts the current computation and raises a
! 83: .BI "stack overflow"
! 84: exception. If this occurs frequently (especially if you make heavy use
! 85: of linear algebra), start with a bigger stack. The stack size can also be
! 86: increased from within GP, using
! 87: .B default(parisize, ...)
! 88: ; it may be convenient to set
! 89: .B stacksize
! 90: from your
! 91: .B .gprc
! 92: Note that computations with a
! 93: .B smaller
! 94: stack may be more efficient due to better data locality. Sensible
! 95: computations should need less than 20MB.
! 96:
! 97: .TP
! 98: .B \-test
! 99: run GP in test mode: suppress printing of history numbers and wrap long
! 100: output lines (to get readable diff output). For benches only.
! 101: .SH USE
! 102: .TP
! 103: .B ?
! 104: to get online help.
! 105: .TP
! 106: .B ??
! 107: to get extended online help (more precisely, to call the external help
! 108: program,
! 109: .B gphelp
! 110: by default)
! 111: .TP
! 112: .B quit
! 113: (or \\q), or
! 114: .B EOF
! 115: (Ctrl-D) to quit
! 116: .BR gp .
! 117: .PP
! 118: The following works only when gp was linked with GNU
! 119: .IR readline
! 120: library:
! 121: .TP
! 122: arrow keys
! 123: for editing and viewing the input history.
! 124: .TP
! 125: .B TAB
! 126: for automatic completion
! 127:
! 128: .SH MANUALS
! 129: The following material is included in the standard distribution (originally
! 130: in TeX format):
! 131: .TP
! 132: .I The PARI/GP Users's Manual
! 133: (users.dvi)
! 134: .TP
! 135: .I PARI/GP, a tutorial
! 136: (tutorial.dvi): not yet completed but still useful.
! 137: .TP
! 138: .I PARI/GP reference card
! 139: (refcard.ps): 4 pages, based on an earlier version by Joseph H. Silverman.
! 140: .TP
! 141: .I pariemacs.txt
! 142: explains the use of the pari.el package, and how to customize it (prompt,
! 143: colors).
! 144:
! 145: .SH FILES
! 146: .TP
! 147: .I gp
! 148: main executable
! 149: .TP
! 150: .I $HOME/.gprc
! 151: (or $GPRC if set) read at beginning of execution by each
! 152: .B gp
! 153: shell. A default gprc
! 154: .I gprc.dft
! 155: is provided with the distribution. If this file cannot be found,
! 156: .I /etc/gprc
! 157: is checked instead.
! 158: .TP
! 159: .I pari.log
! 160: default logfile (can be changed in
! 161: .I .gprc
! 162: or interactively using
! 163: .B default()
! 164: )
! 165: .TP
! 166: .I pari.ps
! 167: default psfile used for postscript output (as above)
! 168: .TP
! 169: .I /usr/local/bin/gphelp
! 170: default external help program (as above)
! 171: .TP
! 172: .I /usr/local/lib/pari/pari.el
! 173: elisp package to run pari in an
! 174: .I Emacs
! 175: shell. Must be loaded from your
! 176: .I .emacs
! 177: file.
! 178: .TP
! 179: .I *.gp
! 180: gp programs
! 181:
! 182: .SH ENVIRONMENT
! 183: .TP
! 184: .I $GPRC
! 185: place to look for the user's gprc file (before $HOME/.gprc, ./gprc, and
! 186: /etc/gprc in this order).
! 187:
! 188: .TP
! 189: .I $GP_DATA_DIR
! 190: directory containing the Galois resolvents files (needed by the
! 191: .B polgalois
! 192: function, for degrees 8 to 11).
! 193:
! 194: .SH PRIMARY FTP SITE
! 195: The most recent distributions can be found at
! 196: .RS
! 197: .I ftp://megrez.math.u-bordeaux.fr/pub/pari
! 198: .RE
! 199:
! 200: Tips, development info, nice icons and bad jokes can be found at
! 201: PARI home page, set up by Gerhard Niklasch at
! 202: .RS
! 203: .I http://www.parigp-home.de/
! 204: .RE
! 205:
! 206: .SH MAILING LISTS
! 207: There are three mailing lists devoted to the PARI/GP package (run courtesy
! 208: of Dan Bernstein), and most feedback should be directed to those. They are:
! 209:
! 210: .PP
! 211: -
! 212: .B pari-announce
! 213: (moderated): for us to announce major version changes.
! 214: .PP
! 215: -
! 216: .B pari-dev:
! 217: for everything related to the development of PARI, including
! 218: suggestions, technical questions, bug reports or patch submissions.
! 219:
! 220: .PP
! 221: -
! 222: .B pari-users:
! 223: for everything else.
! 224:
! 225: To subscribe, send empty messages respectively to
! 226:
! 227: .PP
! 228: pari-announce-subscribe@list.cr.yp.to
! 229: .PP
! 230: pari-users-subscribe@list.cr.yp.to
! 231: .PP
! 232: pari-dev-subscribe@list.cr.yp.to
! 233:
! 234: .SH BUG REPORTS
! 235: If you find a bug, you should report it. First make sure that it really
! 236: is a bug and that it appears in recent versions of the package.
! 237: Then you can actually mail your bug report (make it short
! 238: and easily reproducible if possible), including the header
! 239: .B gp
! 240: displays on startup, to the
! 241: .IR pari-dev
! 242: mailing list (preferably) or to
! 243: .IR pari@math.u-bordeaux.fr .
! 244: Fixes are welcome too !
! 245:
! 246: .SH TRIVIA
! 247: Despite the leading G, GP has nothing to do with GNU. The first version was
! 248: originally called GPC, for Great Programmable Calculator. For some reason,
! 249: the trailing C was eventually dropped.
! 250:
! 251: PARI has nothing to do with the French capital. The name is a pun about the
! 252: project's early stages when the authors started to implement a library for
! 253: "Pascal ARIthmetic" in the PASCAL programming language (they quickly
! 254: switched to C).
! 255:
! 256: For the benefit of non-native French speakers, here's a slightly expanded
! 257: explanation:
! 258: .B Blaise Pascal
! 259: (1623-1662) was a famous French mathematician and philosopher who was one
! 260: of the founders of probability and devised one of the first "arithmetic
! 261: machines". He once proposed the following "proof" of the existence of God
! 262: for the unbelievers: whether He exists or not I lose nothing by believing
! 263: in Him, whereas if He does and I misbehave... This is the so-called "pari
! 264: de Pascal" (Pascal's bet).
! 265:
! 266: Note that PARI also means "fairy" in Persian.
! 267:
! 268: .SH AUTHORS
! 269: PARI was originally written by Christian Batut, Dominique Bernardi, Henri
! 270: Cohen, and Michel Olivier in Laboratoire A2X (Universite Bordeaux I, France),
! 271: and was maintained by Henri Cohen up to version 1.39.15, and by Karim Belabas
! 272: since then.
! 273:
! 274: A great number of people have contributed to the successive improvements
! 275: which eventually resulted in the present version. See the AUTHORS file in
! 276: the distribution.
! 277:
! 278: .SH SEE ALSO
! 279: .IR dvips (1),
! 280: .IR emacs (1),
! 281: .IR gap (1),
! 282: .IR ghostview (1),
! 283: .IR gphelp (1),
! 284: .IR maple (1),
! 285: .IR perl (1),
! 286: .IR readline (3),
! 287: .IR tex (1),
! 288: .IR xdvi(1)
! 289:
! 290: .SH COPYING
! 291:
! 292: This program is free software; you can redistribute it and/or modify it under
! 293: the terms of the GNU General Public License as published by the Free Software
! 294: Foundation.
! 295:
! 296: This program is distributed in the hope that it will be useful, but WITHOUT
! 297: ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
! 298: FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
! 299:
! 300: You should have received a copy of the GNU General Public License along with
! 301: this program; if not, write to the Free Software Foundation, Inc., 675 Mass
! 302: Ave, Cambridge, MA 02139, USA.
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>