IMS Open Corpus Workbench: CWB/Perl CL Version 2.2.102 compatible with CWB version 3.0 (2.2.101 and newer) This package contains a Perl interface to the low-level corpus access library (CL) of the IMS Open Corpus Workbench. Note that you will need a working C compiler (the same used to compile your version of Perl) in order to build and install this package. PREREQUISITES Before compiling the CWB/Perl package, you must install an up-to-date version of the IMS Open Corpus Workbench (see above for precise version requirements). You can either compile the CWB from source or install a binary distribution available from http://cwb.sourceforge.net/. If you did not install the CWB in a standard place (i.e. in a directory in your search path), make sure that the "cwb-config" program can be executed from the command line. This will enable the CWB/Perl makefile to obtain the necessary configuration information. You will also need a working C compiler (the same used to compile your version of Perl). If you have installed a binary distribution of the CWB, the CL library (libcl.a) included there might not be compatible with your C compiler. In this case, you will need to compile the IMS Open CWB yourself from source. QUICK INSTALLATION GUIDE If you have never installed a Perl module before: don't despair. All you have to do -- provided that the prerequisites are met -- is to execute the following commands: perl Makefile.PL make make test make install You will probably have to login as root for the last step (or you can type "sudo make install" and enter your root password). If you want to install the Perl modules in a non-standard location, say in "~/perl/lib/perl5/..." and "~/perl/man/...", type the following instead of "perl Makefile.PL": perl Makefile.PL PREFIX=~/perl INSTALLMAN1DIR=~/perl/man/man1 Note that you will then have to include the appropriate subdirectories of "~/perl/lib/perl5/" in your Perl search path in order to use the CWB modules. If the "cwb-config" utility is not in your standard search path, you can specify its location with the --config option: perl Makefile.PL --config=~/cwb-3.0/bin/cwb-config PACKAGE OVERVIEW This package installs two Perl modules: CWB::CL Perl API for the low-level CWB corpus access library CWB::CL::Strict convenience wrapper for automatic error checking Unfortunately, there is no complete documentation yet for the CWB::CL module (neither for the CWB Corpus Library itself). Type "perldoc CWB::CL" for a synopsis of the CL API and its usage from Perl. Note that most of the methods defined by CWB::CL correspond directly to functions in the CL library. A good starting point for your own work with CWB::CL is the commented example script in the "examples/" subdirectory. If you have installed the CWB demo corpus (DICKENS), you should be able to run "perl examples/dickens.perl" (set the CORPUS_REGISTRY environment variable if necessary). The script "examples/benchmark.perl" allows you to test the performance of the CWB::CL interface and compare it to the older CL.pm module (provided that the old module is still installed on your system). COPYRIGHT Copyright (C) 1999-2010 by Stefan Evert [http::/purl.org/stefan.evert] This software is provided AS IS and the author makes no warranty as to its use and performance. You may use the software, redistribute and modify it under the same terms as Perl itself.