CPAN-Search-Lite documentation | view source
 CPAN::Search::Lite::Index - set up or update database tables.


NAME

CPAN::Search::Lite::Index - set up or update database tables.

__top


SYNOPSIS

 my $index = CPAN::Search::Lite::Index->new(config => 'cpan.conf', setup => 1);
 $index->index();

__top


DESCRIPTION

This is the main module used to set up or update the database tables used to store information from the CPAN and ppm indices. The creation of the object

 my $index = CPAN::Search::Lite::Index->new(%args);

accepts three arguments:

__top


CONFIGURATION

Most of the options used to control the behaviour of the indexing are contained in a configuration file. An example of the format of such a file is

 [CPAN]
 CPAN = /var/ftp/pub/CPAN
 pod_root = /usr/local/POD
 html_root = /usr/local/httpd/htdocs/CPAN
 [DB]
 db = pause
 user = sarah
 passwd = lianne
 [WWW]
 css = cpan.css
 up_img = up.gif
 tt2 = /usr/local/tt2
 geoip = /usr/local/share/geoip/cpan.txt

This consists of 3 sections.

CPAN

This is associated with various things related to CPAN.

DB

This is used to store connection information to the database used to populate the tables.

WWW

This is used for various information related to a web interface.

__top


DETAILS

Calling

  $index->index();

will start the indexing procedure. Various messages detailing the progress will written to STDOUT, which by default will be captured into a file cpan_search_log.dddddddddd, where the extension is the time that the method was invoked. Passing index an argument of log => log_file will save these messages into log_file. Error messages are not captured, and will appear in STDERR.

The steps of the indexing procedure are as follows.

__top


SEE ALSO

the CPAN::Search::Lite::Info manpage, the CPAN::Search::Lite::PPM manpage, the CPAN::Search::Lite::State manpage, the CPAN::Search::Lite::Extract manpage, the CPAN::Search::Lite::Populate manpage, and the CPAN::Search::Lite::Util manpage. Development takes place on the CPAN-Search-Lite project at http://sourceforge.net/projects/cpan-search/.

__top


COPYRIGHT

This software is copyright 2004 by Randy Kobes <randy@theoryx5.uwinnipeg.ca>. Use and redistribution are under the same terms as Perl itself.

__top

 CPAN::Search::Lite::Index - set up or update database tables.

CPAN-Search-Lite documentation | view source