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