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.