
XPLAB - Pattern Matching for OCR
================================

XPLAB is a GUI driven interactive pattern matching  program for
LINUX/UNIX. XPLAB is focused to OCR but not constrained to it. 

XPLAB is available from http://www.pattern-lab.de/gui2.html
Contact: info@pattern-lab.de


After downloading the tarball "xplab-VERSION.tgz", perform the following
steps.


1. Preview of the tarball

If you want a preview of the tarball's content and doing nothing else  
('VERSION' to be updated):-

	tar -tzf xplab-VERSION.tgz


2. Unpacking the tarball

Unpack the tar file into a user's directory, assuming write permission:-

	tar -vxzf xplab-VERSION.tgz


3. Building

Enter the created directory `./xplab-VERSION/src/' and run "make", which
uses the file 'Makefile' as default. There should be no compilation
errors nor warnings. The result is the executable 'xplab'.

Some problems have been seen because of the graphical lib GTK+. This is
due to the fact, that different dependencies on different systems can
exist. If there are any better configurations for the building, please
let me know. Sometimes it might help to weaken the compiler's strictness
by commenting out options like '-Wstrict-prototypes' or the like in the
Makefile as a quick hack.

Use the right version of GTK+. The current version used is GTK+ 2.6.4,
however, slightly older versions may compile as well. GTK 1 versions
don't compile definitely.


4. Testing

For a quick test enter 'xplab -h' or 'xplab -v', respectively. The first
command prints the help menu onto the screen, the second one the
version and licence.

For an intensive test change the directory to './xplab-VERSION/testa/'
and enter './xrun_tp' (a PERL 5 test-routine). XPLAB performs a lot of
tests doing recognition and clustering. Even if these tests do not touch
all functions of XPLAB, they still lets XPLAB do a hard work with
bothering it's most sensitive parts.


5. Installing

Sorry, no install procedure for XPLAB. XPLAB is currently in a developer
stage. It is usable for own trials.


6. Documentation

The file xplab.1.gz contains the man page of XPLAB. To get the man
page available system-wide, just copy the zipped man page xplab.1.gz
into the MANPATH, e.g.

	"cp xplab.1.gz /usr/share/man/man1/" 

(normally as root). Now the man page is called entering 

        "man xplab"

For further details how to manage man pages refer to

	http://www.schweikhardt.net/man_page_howto.html.


See XPLAB's Home Page http://www.pattern-lab.de/gui2.html for further
information.


7. Help and Bug Reports

If you need support don't hesitate to ask me, but be warned, I am
neither an expert for computer systems nor for mathematics. If you have
comments, improvements, suggestions, etc. please tell me.

	info@pattern-lab.de


8. Licence

See for file COPYING (GNU Public License).

