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