Search::Xapian version 1.2.8.0 ============================== This is Search::Xapian, a Perl XS interface to the Xapian C++ search library. In the next release series (Xapian 1.4.x) these hand-coded XS wrappers will be replaced with a version generated with SWIG. This means that new C++ API features can be wrapped for Perl more quickly and easily than currently. These new wrappers attempt to be compatible with the current ones, but we encourage you to try them with your code and report any incompatibilities so we can attempt to address them. Currently this work in on trunk in the Xapian SVN tree, and it will be available in the forthcoming Xapian 1.3.0 development release. INSTALLATION To install this module type the following: perl Makefile.PL make make test make install By default, Makefile.PL looks for xapian-config on your PATH. You can specify a path for xapian-config by passing XAPIAN_CONFIG=/path/to/xapian-config on the command line after Makefile.PL. Similarly, you can specify a C++ compiler by passing CXX=/usr/local/bin/g++ after Makefile.PL, as well as CXXFLAGS and CPPFLAGS to add additional compiler flags. For example: perl Makefile.PL XAPIAN_CONFIG=/home/jim/bin/xapian-config CXX=g++-4.3 These values are stored in the generated Makefile and will be used if "make" causes "perl Makefile.PL" to be automatically rerun (e.g. if you modify Makefile.PL). (For compatibility with what Search::Xapian 1.0.3.0 and earlier required, XAPIAN_CONFIG and CXX can also be specified as environmental variables. Specifying them on the command line is preferred because it avoids issues with differing syntax between shells and having to export variables). DEPENDENCIES Search::Xapian currently requires Perl >= 5.6. To work well in a threaded Perl script (i.e. when "use threads;" is in use), Perl >= 5.8.7 is required. This module requires these other modules and libraries: The Xapian C++ search library, which can be downloaded by following the instructions on http://xapian.org/ DOCUMENTATION Most of the classes have POD documentation, which you can view using perldoc or man (e.g. perldoc Search::Xapian::Database). The Perl API closely follows the C++ API in most places, so the documentation for Xapian itself is generally applicable: COPYRIGHT AND LICENCE Please report any bugs/suggestions to or use the Xapian bug tracker . Please do NOT use the CPAN bug tracker or mail any of the authors individually. Copyright (c) 2002,2003 Alex Bowley. All rights reserved. Copyright (c) 2003,2004,2005,2006,2007,2008,2009,2010,2011 Olly Betts. All rights reserved. Copyright (c) 2010 Adam Sjøgren This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.