This module wraps all of the 'mpq' (rational) functions that the Gnu MP (GMP) library provides. It requires gmp-4.2.0 or later. You therefore need the GMP library installed on your computer. See: http://gmplib.org/ To build this module you need perl 5.6.0 or later. I'm not sure of all the requirements to get it to build with earlier versions of perl, but it's definite that the XS code relating to operator overloading will not compile with perl versions prior to 5.6. No OO interface - just plain access to GMP's rational number functions. Build in the usual way: perl Makefile.PL make make test make install When building this module, the GMP library will need to be accessible. If it's in a location where your compiler does not find it by default, then instead of running 'perl Makefile.PL', you'll need to run: perl Makefile.PL INC="-I/path/to/gmp_include" LIBS="-L/path/to/gmp_lib -lgmp" ============== 64-bit support ============== If your perl's Config reports that 'ivsize' is greater than or equal to 8, then Math::GMPq will, by default, be built to enable you to use the 64-bit long long int values with the new() function and the overloaded operators. Else attempts to use long long int values with Math::GMPq will probably fail. If necessary, you can override the default by opening up the Makefile.PL and uncommenting the appropriate line (just a few lines down from the top of the file ... the comments in that file should make it clear). Similarly, if your perl's Config reports that 'nvsize' > 8, then Math::GMPq will, by default, be built to enable you to use the long double values with the new() function and the overloaded operators. Else, attempts to use long doubles will probably fail. If you need, you can override the default by opening up the Makefile.PL and uncommenting the appropriate line (just a few lines down from the top of the file ... the comments in that file should make it clear). I believe it to be both unnecessary and inadvisable to override the default - but if you do find that you need to override the default, please let me know. That you have found it necessary to override the default is something I probably ought to know about. I am contactable by email at sisyphus at(@) cpan dot (.) org. ========== MAC OS X ========== If you have MacPorts installed, you may need to install gmp +universal for the bindings to work. After installing you'll need to run: perl Makefile.PL INC="-I/opt/local/include" LIBS="-L/opt/local/lib -lgmp" ========== MS WINDOWS ========== If building with an MSVC++ compiler against a MinGW-built gmp lib, you'll need to additionally link to MinGW's libgcc.a and libcoldname.a. First, create copies of the 3 '.a' files (named libgmp.lib, libgcc.lib, and libcoldname.lib) and then run: perl Makefile.PL INC="-IC:/path/to/gmp_include" LIBS="-LC:/path/to/gcc_lib -lgcc -LC:/path/to/coldname_lib -lcoldname -LC:/path/to/gmp_lib -lgmp"