Read Me
<?xml version="1.0" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>DESCRIPTION</title>
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<link rev="made" href="mailto:root@localhost" />
</head>
<body style="background-color: white">
<!-- INDEX BEGIN -->
<div name="index">
<p><a name="__index__"></a></p>
<ul>
<li><a href="#description">DESCRIPTION</a></li>
<li><a href="#dependencies">DEPENDENCIES</a></li>
<li><a href="#installation">INSTALLATION</a></li>
<li><a href="#build_options">BUILD OPTIONS</a></li>
<li><a href="#known_bugs">KNOWN BUGS</a></li>
<li><a href="#author">AUTHOR</a></li>
</ul>
<hr name="index" />
</div>
<!-- INDEX END -->
<p>README for package ddc</p>
<p>Last updated for ddc v2.0.0</p>
<p>
</p>
<hr />
<h1><a name="description">DESCRIPTION</a></h1>
<p>The ddc package contains core C++ utilities
for the DWDS/Dialing Concordance document indexing
system.</p>
<p>The DDC-2.x branch is maintained in SVN under:</p>
<pre>
https://ddc-concordance.svn.sourceforge.net/svnroot/ddc-concordance</pre>
<p>
</p>
<hr />
<h1><a name="dependencies">DEPENDENCIES</a></h1>
<dl>
<dt><strong><a name="ddc_morph_v2_0_0" class="item">ddc-morph >= v2.0.0</a></strong></dt>
<dd>
<p>Morphology data.</p>
<p>In order to use most of the runtime utilities,
you will also need a set of morphology data files
available in the ddc-morph package, which should be available
wherever you downloaded these sources.</p>
<p>You should build (and optionally install)
this package <strong>BEFORE</strong> attempting to build ddc-morph.</p>
<p>The ddc-morph sources are maintained in SVN under:</p>
<pre>
https://ddc-concordance.svn.sourceforge.net/svnroot/ddc-morph</pre>
</dd>
<dt><strong><a name="libpcre_libpcrecpp" class="item">libpcre, libpcrecpp</a></strong></dt>
<dd>
<p>Perl-compatibile regular expression C library and C++ wrappers.</p>
<p>URL: <a href="http://www.pcre.org/">http://www.pcre.org/</a></p>
<p>Tested version(s): 8.02</p>
</dd>
<dt><strong><a name="libcurl" class="item">libcurl (optional)</a></strong></dt>
<dd>
<p>If available, libcurl can be used for accessing external HTTP-based
term expanders from within a running DDC process. DDC should
still compile and run even if libcurl is unavailable,
but e.g. external HTTP-based term expanders will be unuseable.</p>
<p>URL: <a href="http://curl.haxx.se/">http://curl.haxx.se/</a></p>
<p>Tested version(s): 7.21.0</p>
</dd>
</dl>
<p>
</p>
<hr />
<h1><a name="installation">INSTALLATION</a></h1>
<p>Issue the following commands to the shell:</p>
<pre>
cd ddc-X.Y.dx-Z ##-- (or wherever you extracted the ddc distribution)
sh ./configure
make
make install</pre>
<p>To build the ddc morph package, then do:</p>
<pre>
cd ..
cd ddc-morph-X.Y-dx-Z ##-- (or wherever the ddc-morph distribution lives)
sh ./configure
make
make install</pre>
<p>Finally, set the (legacy) environment variable RML to the directory
into which ddc was installed (by default /usr/local/ddc):</p>
<pre>
export RML=/usr/local/ddc</pre>
<p>... and you ought to be ready to roll. Take a look at the configuration
files in $RML/etc/ and the example corpora in Test/ to get started.</p>
<p>
</p>
<hr />
<h1><a name="build_options">BUILD OPTIONS</a></h1>
<p>The 'configure' script supports the following options, among others:</p>
<dl>
<dt><strong><a name="prefix_prefix" class="item">--prefix=PREFIX</a></strong></dt>
<dd>
<p>Installation prefix (default=/usr/local).
This package installs itself to:</p>
<pre>
PREFIX/ddc ##-- root directory (a.k.a. $RML)
PREFIX/ddc/bin ##-- executable programs & scripts
PREFIX/ddc/etc ##-- runtime configuration files
PREFIX/ddc/include ##-- C++ headers
PREFIX/lib ##-- runtime libtool libraries</pre>
<p>Additionally, the package requires a directory PREFIX/ddc/dict
containing morphology data, which should be installed by
the ddc-morph package (see <a href="#dependencies">DEPENDENCIES</a>).</p>
</dd>
<dt><strong><a name="enable_debug" class="item">--enable-debug</a></strong></dt>
<dd>
<p>Enable debugging flags. Only works for GNU C++ compiler.</p>
</dd>
<dt><strong><a name="enable_warnings" class="item">--enable-warnings</a></strong></dt>
<dd>
<p>Enable lots of compiler warnings. Only works for GNU C++ compiler.</p>
</dd>
<dt><strong><a name="disable_shared" class="item">--disable-shared</a></strong></dt>
<dd>
<p>Disable compilation of shared libraries.</p>
</dd>
<dt><strong><a name="without_libcurl" class="item">--without-libcurl</a></strong></dt>
<dd>
<p>Force DDC to build without CURL support.</p>
</dd>
</dl>
<p>See the output of `./configure --help` for details on additional
supported options.</p>
<p>
</p>
<hr />
<h1><a name="known_bugs">KNOWN BUGS</a></h1>
<p>Many.</p>
<p>
</p>
<hr />
<h1><a name="author">AUTHOR</a></h1>
<p>Alexey Sokirko wrote DDC.</p>
<p>Bryan Jurish <<a href="mailto:jurish@bbaw.de">jurish@bbaw.de</a>> made various improvements and maintains the DDC-2.x branch.</p>
</body>
</html>