IMS Open Corpus Workbench: CQi reference implementation Version 3.0.0 compatible with CQi version 0.1 / CWB version 3.0+ This package contains a reference implementation of the CQi client-server protocol for the Perl programming language. In addition to a client API library and a CQPserver launcher, several example scripts illustrating usage of the CQi interface are included. PREREQUISITES As a CQi client library that connects to a remote corpus server, this package works with any recent Perl distribution and does not require a copy of the IMS Open Corpus Workbench to be available. The CQPserver launcher can only be used if the "cqpserver" program and the basic CWB/Perl package have been installed. QUICK INSTALLATION GUIDE If you have never installed a Perl module before: don't despair. All you have to do 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 CWB/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. PACKAGE OVERVIEW The CQi reference implementation of the following Perl modules CWB::CQI specification of the CQi protocol (command bytecodes) CWB::CQI::Client CQi client library CWB::CQI::IOClient alternative version using IO::Socket interface CWB::CQI::CQPserver launcher for local CQPserver (if installed) See the manual pages (e.g. "perldoc CWB::CQI::Client") of these modules for further information. The package also contains a number of example scripts in the directory "examples/". If the IMS Open Corpus Workbench and the basic CWB/Perl interface are installed, these examples will automatically launch CQPserver on the local machine. Otherwise, you have to start CQPserver manually on a remote corpus server and specify the connection details when running each example script. COPYRIGHT Copyright (C) 1999-2020 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.