
=================================================

This is DDC 1.1, a search engine for linguists.

DDC is an acronym for "Dialing DWDS Concordance". 
DWDS is an acronym for Digitales Woerterbuch der Deutschen Sprache 
des 20. Jahrhunderts (www.dwds.de).

DDC is distributed under the Library GNU Public Licence, which is in the file
COPYING.  

DDC was written by Alexey Sokirko.  The project was started in Moscow in Dialing 
Company and it was finished at Berlin-Brandenburg Academy of Sciences 
and Humanities in  Berlin (the project DWDS). 

The system has been developed under Windows 2000 (MS VS 6.0), but
has also been compiled and run under Linux(GCC).  It should work with
minor changes on other systems.

DDC uses a regular expression library "PCRE" (Perl Compatible Regular Expressions).
We test compilation only with version 6.4. Other versions were not tested. 
One should download this version  from the official site and install it 
to the default place. If you do not want to install it or you do not have enough
rights to do it, then you should  create two environment variables: 
	1.  RML_PCRE_LIB, that  points to PCRE library directory, where
libpcre.a and libpcrecpp.a should be located, for example:
	export RML_PCRE_LIB=~/RML/contrib/pcre-6.4/.libs
    2  RML_PCRE_INCLUDE, that points to PCRE include catalog, 
where "pcrecpp.h" is located, for example
    export RML_PCRE_INCLUDE=~/RML/contrib/pcre-6.4




This package was a little bit updated for our needs that's why one need not download it from 
its oficial site. Everything is included.

DDC uses TinyXml library (http://sourceforge.net/projects/tinyxml/)
in order to parse XML.


Website of DDC: www.aot.ru, http://sourceforge.net/projects/ddc-concordance.


Bug reports should be sent to sokirko@yandex.ru, sokirko@dwds.de

Contents of the this archive

1.	Sources of the main Concordance Library (Source/ConcordLib).
2.	Sources of the indexing program (Source/ConcordIndex).
3.	Sources of the simple querying program (Source/ConcordSimple).
4.	Sources of the Concordance Daemon Library (Source/ConcordDmnLib).
5.	Sources of the Concordance Daemon (Source/ConcordDaemon).
6.	CGI-script for querying Concordance(Source/Search).



Your system should have flex and bison installed in order to compile the sources.
I use bison 1.875 and flex 2.5.4 to process query language.
I compiled all sources with gcc 3.2. Lower versions are not supported.


=================================================
====== 					 Installation       =====
=================================================

Unpacking

* Create  a catalog and  register a system variable RML, which  points 
to this catalog:
	mkdir /home/sokirko/RML
	export  RML=/home/sokirko/RML

* Put "concord.tar.gz" to this catalog, unpack it 
 	tar xfz concord.tar.gz



Compiling DDC

  0. Do not forget to set  RML_PCRE (see above)

  1. cd $RML

  2. ./compile_concord.sh


  The script should create in $RML\Bin programs ConcordIndex, 
  ConcordConsole, ConcordDaemon, ddc_xml and Search.

  The script should terminate with message "Compilation was successful".   


Checking DDC (optional test suite)


Important! In order to run DDC test suite you are to compile 
and to build at least one RML morphological dictionary. 
Visit http://sf.net/projects/morph-lexicon to download and install 
these modules.

User can check DDC with the following commands:

  1. cd $RML

  2. ./check_concord.sh <lang>

  where <lang> can be Russian, English or German.

  
The script should terminate with message "The check is passed".   

The descriptions of DDC programs are in DDCReadme.pdf.
