Annotation of OpenXM_contrib/pari-2.2/doc/gp.1, Revision 1.1.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>