diff options
-rw-r--r-- | NEWS | 4 | ||||
-rw-r--r-- | README | 85 | ||||
-rw-r--r-- | THANKS | 1 | ||||
-rw-r--r-- | configure.ac | 2 | ||||
-rw-r--r-- | lib/Makefile.am | 2 |
5 files changed, 53 insertions, 41 deletions
@@ -1,11 +1,11 @@ -GNU Dico NEWS -- history of user-visible changes. 2010-07-04 +GNU Dico NEWS -- history of user-visible changes. 2010-07-07 Copyright (C) 2008, 2009, 2010 Sergey Poznyakoff See the end of file for copying conditions. Please send Dico bug reports to <bug-dico@gnu.org.ua> -Version 2.0.92 (GIT) +Version 2.1, 2010-07-07 * Normalize exit codes. @@ -6,12 +6,12 @@ Copyright (C) 2008, 2009, 2010 Sergey Poznyakoff This file contains brief information about configuring, testing and running GNU Dico. It is *not* intended as a replacement -for the documentation, it is provided as a brief reference only. +for the documentation, but is provided as a brief reference only. The (almost) complete documentation for Dico is available in doc/ subdirectory. To read it without installing the package run `info -f doc/dico.info'. After the package is installed the documentation can be accessed running `info Dico'. Invoking -`info dico' and `info dicod' (with lower-case `d') will show you a +`info dico' and `info dicod' (with a lower-case `d') will show you a concise description of the command line syntax (similar to a man-page style) of `dico' and `dicod' programs, correspondingly. @@ -21,17 +21,22 @@ at http://dico.man.gnu.org.ua. * Overview ========== -Dico is an implementation of DICT server (RFC 2229). It is fully -modular: the daemon itself (dicod) provides only the server -functionality, but it knows nothing about database formats. Actual +Dico is a flexible implementation of DICT server (RFC 2229). The +server is modular: the daemon itself (dicod) provides only the server +functionality, and knows nothing about database formats. Actual searches are performed by functions supplied in loadable modules. A -single module can serve one or more databases. +single module can handle any number of database instances. The package includes several modules for searching in different dictionary databases, among them a module for dict.org databases and a module for databases in Emacs "outline" format. -A console client program, `dico', is also included. +The server can be configured to handle both anonymous and authorized +access. It supports a wide variety of authentication algorithms. +Simpler configurations can keep the user database in plaintext files, +while more complex ones can use LDAP. + +A console client program, `dico', is included. A module for lookups in Jim Breen's Kanjidic and Edict databases will be added in future. @@ -42,29 +47,37 @@ be added in future. Dico is informal French for "Dictionary". It is pronounced "Deekoh", with the stress on the last syllable. -* Current state -=============== - -The dicod daemon is completely implemented. It provides all the -functionality required by RFC 2229, including SASL authentication. +* Modules +========= -The package comes with the following database modules: +The package comes with the following modules: - dictorg - This module handles databases in dict.org format. + This module handles databases in dict.org format. - guile - An abstract layer for interfacing with database modules written in - Guile. + An abstract layer for interfacing with database modules written in + Guile. - python - An abstract layer for interfacing with database modules written in - Python. + An abstract layer for interfacing with database modules written in + Python. - outline - Support for databases in Emacs outline format. This module is - designed mostly as an example and for testing purposes. + Support for databases in Emacs outline format. This module is + designed mostly as an example and for testing purposes. + +- substr + Defines the "substr" lookup strategy, which matches a supplied + substring anywhere in the headword. +- stratall + Defines a special lookup strategy, named "all", which returns all + headwords from the database. + +- ldap + Brings support for LDAP user databases. + * Building ========== @@ -82,34 +95,33 @@ Dico. ------------------------ The runtime configuration system uses `m4' to preprocess the -configuration file. This makes the configuration extremely flexible. -We recommend to use GNU m4 as a preprocessor. However, any other -implementation of `m4' may be used. The `configure' script tries to -determine full file name of the preprocessor binary and the necessary +configuration file, which makes the configuration extremely flexible. +We recommend to use GNU m4 as a preprocessor, although any other +implementation of `m4' can be used as well. The `configure' script tries to +determine the full file name of the preprocessor binary and the necessary command line options. In case it makes a wrong guess, you can instruct -it to use a particular preprocessor by using `DEFAULT_PREPROCESSOR' +it to use a particular preprocessor by defining the `DEFAULT_PREPROCESSOR' configuration variable. For example, the following `configure' invocation instructs it to use `/usr/local/bin/gm4': $ ./configure DEFAULT_PREPROCESSOR="/usr/local/bin/gm4 -s" -Note the use of `-s' preprocessor option. It instructs `m4' to +Note the use of the `-s' preprocessor option. It tells `m4' to produce line directives which help `dicod' produce correct diagnostics about eventual configuration errors. Unless your `m4' implementation does not have this feature, we recommend to always use it in `DEFAULT_PREPROCESSOR' value. - Finally, if you do not wish to use preprocessor at all, you can -disable it using `--without-preprocessor' option to `configure'. + Finally, if you do not wish to use preprocessor at all, use +the `--without-preprocessor' option. ** Default Server ----------------- Unless given an explicit dictionary server, the client program `dico' -attempts to connect the server `dict://dico.gnu.org.ua'. You may -change this default by defining the DEFAULT_DICT_SERVER variable. For -example, the following command line selects dict.org as the default -server: +attempts to connect the server `dict://dico.gnu.org.ua'. You can +change this default by setting the DEFAULT_DICT_SERVER environment +variable to the desired server hostname. For example: $ ./configure DEFAULT_DICT_SERVER=dict.org @@ -129,10 +141,9 @@ If you do not wish to use Guile, use `--without-guile' to disable it. ---------------------------- The `dicod' daemon uses syslog for diagnostics. The default syslog -facility can be set using `LOG_FACILITY' configuration variable. Its -allowed arguments are `user', `daemon', `auth', `authpriv', `mail', -`cron', and `local0' through `local7'. Case is not significant. In -addition, these words can be prefixed with `log_'. +facility can be set using `LOG_FACILITY' configuration variable. +Allowed arguments are `user', `daemon', `auth', `authpriv', `mail', +`cron', and `local0' through `local7' (case insensitive). By default, the `daemon' facility is used. @@ -143,7 +154,7 @@ Send bug reports to <bug-dico@gnu.org>. * Copyright information: -Copyright (C) 2008, 2009 Sergey Poznyakoff +Copyright (C) 2008, 2009, 2010 Sergey Poznyakoff Permission is granted to anyone to make or distribute verbatim copies of this document as received, in any medium, provided that the @@ -5,4 +5,5 @@ suggesting various improvements or submitting actual code. Here is a list of these people. Help us keep it complete and exempt of errors. Karl Berry <karl@freefriends.org> +Marc Dequènes <duck@duckcorp.org> Wojciech Polak <polak@gnu.org> diff --git a/configure.ac b/configure.ac index 7da7d17..5ff8aa8 100644 --- a/configure.ac +++ b/configure.ac @@ -16,7 +16,7 @@ dnl Process this file with -*- autoconf -*- to produce a configure script. # along with GNU Dico. If not, see <http://www.gnu.org/licenses/>. AC_PREREQ(2.63) -AC_INIT([GNU dico], 2.0.92, [bug-dico@gnu.org]) +AC_INIT([GNU dico], 2.1, [bug-dico@gnu.org]) AC_CONFIG_SRCDIR([dicod/main.c]) AM_CONFIG_HEADER(config.h) AC_CONFIG_AUX_DIR([build-aux]) diff --git a/lib/Makefile.am b/lib/Makefile.am index 3538409..5a5c6af 100644 --- a/lib/Makefile.am +++ b/lib/Makefile.am @@ -50,7 +50,7 @@ libdico_la_SOURCES=\ util.c\ xlat.c -libdico_la_LDFLAGS = -version-info 0:0:0 +libdico_la_LDFLAGS = -version-info 1:0:0 libxdico_a_SOURCES=\ appi18n.c\ |