a) Math::Pari is the PERL interface to the PARI part of GP/PARI
(version 2.*). The info about GP/PARI is on
http://www.parigp-home.de/
The first 4 digits after the point of the version of Math::Pari
reflect the latest version of GP/PARI it was tested with.
The next paragraph is an excerpt from documentation inside Pari.pm:
Package Math::Pari is a Perl interface to famous library PARI for
numerical/scientific/number-theoretic calculations. It allows
use of most PARI functions (>500) as Perl functions, and (almost)
seamless merging of PARI and Perl data.
b) In most cases, this module can be installed as all the others, by
perl -MCPAN -e shell
CPAN> install Math::Pari
or
perl -MCPAN -e 'install Math::Pari'
or (if you manually downloaded the archive)
tar -zxfv Math-Pari-2.001200.tar.gz
cd Math-Pari-2.001200
perl Makefile.PL && make && make test && make install
Possible complications are addressed in the file INSTALL:
x) Not having Net::FTP installed and working, and not having
GP/PARI build directory "nearby" (as parent, kid or sibling);
x) Failing compile or configuration: wrong assembler
architecture, wrong paricfg.h (CLK_TCK etc.);
x) the rest of it...
IMPORTANT REMARK: If you try to compile with a different
configuration, please run
make realclean
in between. Otherwise significant problems may arise. [A typical
symptom: the symbol overflow cannot be found.]
c) Due to the apparent recent breakage of PAUSE mirroring of my
directories, CPAN may have not the latest-and-greatest version. :-(
d) How the tests work
Lowercase test scripts translate native GP/PARI tests from GP
syntax to Perl syntax. You can get a better understanding of these
translations by running the tests manually, as in
perl t/all.t
after install, or
perl -Mblib t/all.t
before install. Currently two subtests of t/nfields 'leak' PARI
warnings. Until the test engine is taught to look-for/eat these
warnings, they *must* appear.
e) Reporting bugs/problems
I need to see the output of
perl Makefile.PL
and the relevant messages "near the failure".
elliptic.t subtest 41 often fails on GP/PARI itself, so currently I
do not consider its failure to be a Math::Pari's bug.
f) Documentation to this package is contained inside Pari.pm. After
installing it is accessible by standard means, like
perldoc Math::Pari
man Math::Pari
and possibly in other forms particular for your system.
A copy of documentation of the PARI library in POD format is
provided as well, access it as Math::libPARI:
perldoc Math::libPARI
man Math::libPARI
Since many POD converters are too stupid/buggy to process these
docs, an alternative Math::libPARI.dumb is provided; use as in
perldoc Math::libPARI.dumb
etc.