aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSergey Poznyakoff <gray@gnu.org.ua>2009-03-29 15:15:45 +0300
committerSergey Poznyakoff <gray@gnu.org.ua>2009-03-29 16:00:06 +0300
commit2f9243a64f2c4de97da6b8d8e041c214a7dc302a (patch)
treee63f0c514bba64743311adcb5e509b976bfa213a
parent081142efc7b74babe251496d2487c8faf99a8bb3 (diff)
downloaddico-release-2.0.tar.gz
dico-release-2.0.tar.bz2
Version 2.0release-2.0
* configure.ac: Version 2.0 * Makefile.am (make-ChangeLog): Remove rule * NEWS, README: Update. * doc/dico.texi: Update.
-rw-r--r--Makefile.am26
-rw-r--r--NEWS4
-rw-r--r--README18
-rw-r--r--configure.ac2
-rw-r--r--doc/dico.texi81
-rw-r--r--[-rwxr-xr-x]doc/gendocs_template4
6 files changed, 88 insertions, 47 deletions
diff --git a/Makefile.am b/Makefile.am
index 6c53bfd..0d3dd2f 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -14,34 +14,18 @@
# You should have received a copy of the GNU General Public License
# along with GNU Dico. If not, see <http://www.gnu.org/licenses/>.
-dicodir=@dicodir@
-inputdictpath=@inputdictpath@
-
ACLOCAL_AMFLAGS = -I m4 -I am
SUBDIRS=include utils gnu lib libltdl dicod modules dico tests doc po
#FIXME: add these when ready: makedict client fonts
-EXTRA_DIST = ChangeLog.2008 app dicoweb
+EXTRA_DIST = ChangeLog.2008
-gen_start_date = 2008-05-05
-.PHONY: make-ChangeLog
-make-ChangeLog:
- if test -d .git; then \
- $(top_srcdir)/build-aux/gitlog-to-changelog \
- --since=$(gen_start_date) | \
- sed '/<unknown>$$/d' | fmt -s > $(distdir)/cl-t; \
- echo " " >> $(distdir)/cl-t; \
- echo "Local Variables:" >> $(distdir)/cl-t; \
- echo "mode: change-log" >> $(distdir)/cl-t; \
- echo "version-control: never" >> $(distdir)/cl-t; \
- echo "buffer-read-only: t" >> $(distdir)/cl-t; \
- echo "End:" >> $(distdir)/cl-t; \
- rm -f $(distdir)/ChangeLog; \
- mv $(distdir)/cl-t $(distdir)/ChangeLog; \
- fi
+dist-hook:
+ tar -C $(srcdir) -c -f - --exclude-vcs app dicoweb | \
+ tar -C $(distdir) -x -f -
-dist-hook: make-ChangeLog
+gen_start_date = 2008-05-05
.PHONY: ChangeLog
ChangeLog:
diff --git a/NEWS b/NEWS
index 97d0c7a..edbc141 100644
--- a/NEWS
+++ b/NEWS
@@ -1,11 +1,11 @@
-GNU Dico NEWS -- history of user-visible changes. 2009-03-09
+GNU Dico NEWS -- history of user-visible changes. 2009-03-29
Copyright (C) 2008, 2009 Sergey Poznyakoff
See the end of file for copying conditions.
Please send Dico bug reports to <bug-dico@gnu.org.ua>
-Version 1.99.97 (Git)
+Version 2.0, 2009-03-29
Initial version.
diff --git a/README b/README
index b4d3fec..a7e0668 100644
--- a/README
+++ b/README
@@ -1,5 +1,5 @@
GNU Dico README
-Copyright (C) 2008 Sergey Poznyakoff
+Copyright (C) 2008, 2009 Sergey Poznyakoff
* Introduction
==============
@@ -102,6 +102,18 @@ does not have this feature, we recommend to always use it in
Finally, if you do not wish to use preprocessor at all, you can
disable it using `--without-preprocessor' option to `configure'.
+** 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:
+
+ $ ./configure DEFAULT_DICT_SERVER=dict.org
+
+
** Guile Support
-----------------
@@ -126,12 +138,12 @@ By default, the `daemon' facility is used.
* Bug reporting.
-Send bug reports to <bug-dico@gnu.org.ua>.
+Send bug reports to <bug-dico@gnu.org>.
* Copyright information:
-Copyright (C) 2008 Sergey Poznyakoff
+Copyright (C) 2008, 2009 Sergey Poznyakoff
Permission is granted to anyone to make or distribute verbatim copies
of this document as received, in any medium, provided that the
diff --git a/configure.ac b/configure.ac
index 2b96fb5..2675bc2 100644
--- a/configure.ac
+++ b/configure.ac
@@ -15,7 +15,7 @@ dnl Process this file with -*- autoconf -*- to produce a configure script.
# You should have received a copy of the GNU General Public License
# along with GNU Dico. If not, see <http://www.gnu.org/licenses/>.
-AC_INIT([GNU dico], 1.99.97, [bug-dico@gnu.org.ua])
+AC_INIT([GNU dico], 2.0, [bug-dico@gnu.org])
AC_CONFIG_SRCDIR([dicod/main.c])
AM_CONFIG_HEADER(config.h)
AC_CONFIG_AUX_DIR([build-aux])
diff --git a/doc/dico.texi b/doc/dico.texi
index f937b3a..c3f4854 100644
--- a/doc/dico.texi
+++ b/doc/dico.texi
@@ -307,6 +307,7 @@ options are specific for Dico. We will describe them in this chapter.
@menu
* Default Preprocessor::
+* Default Server::
* Guile Support::
* Python Support::
* Other Settings::
@@ -344,6 +345,24 @@ Finally, if you do not wish to use preprocessor at all, you can
disable it using @option{--without-preprocessor} option to
@command{configure}.
+@node Default Server
+@section Default Server
+@cindex dict server, default
+@vrindex DEFAULT_DICT_SERVER
+
+Unless given an explicit dictionary server, the client program @command{dico}
+attempts to connect the server @indicateurl{dict://dico.gnu.org.ua}. You may
+change this default by defining the @env{DEFAULT_DICT_SERVER} variable. For
+example, the following command line selects @samp{dict.org} as the default
+server:
+
+ $ ./configure DEFAULT_DICT_SERVER=dict.org
+
+The value of the @env{DEFAULT_DICT_SERVER} variable can be either a
+hostname or IP address of the server. It can also be followed by a
+colon and a port specification, either as a decimal number or as
+a service name from @file{/etc/services}.
+
@node Guile Support
@section Guile Support
@cindex guile, configuration
@@ -2274,6 +2293,24 @@ means that the daemon is able to serve only one client at a time. The
@option{--single-process} option is provided for debugging purposes
only. Never use it in production environment.
+@opsummary{transcript}
+@item -T
+@itemx --transcript
+Enable session transcript. This instructs @command{dicod} to log
+all commands it receives and all responses it sends during the
+session. Transcript is logged via the default logging channel
+(@pxref{Logging and Debugging}). If logging via syslog, the
+@samp{debug} priority is used.
+
+See also @ref{Session Transcript}, for a description of the similar
+mode in @command{dico}, the client program.
+
+@opsummary{no-transcript}
+@item --no-transcript
+Disable transcript mode. This is the default. Use this option if you
+wish to temporarly disable transcript mode, enabled in the
+configuration file (@pxref{Logging and Debugging, transcript}).
+
@opsummary{inetd}
@item -i
@itemx --inetd
@@ -2336,7 +2373,7 @@ handler} basis.
GNU Dico version @value{VERSION} is shipped with the following modules:
@samp{Outline}, @samp{Dictorg}, @samp{Guile}, and @samp{Python}. The
-@samp{Outpline} module handles databases written in Emacs Outline
+@samp{Outline} module handles databases written in Emacs Outline
format. It is useful for small databases. The @samp{Dictorg} module
handles databases in format designed by @cite{@acronym{DICT} development
group}. The most existing free databases are written in this format.
@@ -2582,8 +2619,16 @@ should be searched for Scheme modules and libraries. The @var{path}
must be a list of directory names, separated by colons.
This option modifies the value of Guile's @code{%load-path}
-variable. @xref{Build Config, %load-path, {Configuration\, Build and
-Installation}, guile, The Guile Reference Manual}.
+variable.
+@c FIXME: Texi2html is unable to handle \, in the section title. This
+@c conditional overrides this bug.
+@ifnothtml
+@xref{Build Config, %load-path,
+{Configuration\, Build and Installation}, guile, The Guile Reference Manual}.
+@end ifnothtml
+@ifhtml
+See the section @uref{http://www.gnu.org/software/guile/manual/html_node/Build-Config.html, Configuration and Installation} in the Guile Reference Manual.
+@end ifhtml
@end table
@@ -2709,7 +2754,7 @@ load-module @var{mod-name} @{
@kwindex init-fun
Upon module initialization stage, the module attempts to load the
file named @file{@var{script}}. The file is loaded using
-@code{primitive-load} call (@pxref{Load, primitive-load, Loading,
+@code{primitive-load} call (@pxref{Loading, primitive-load, Loading,
guile, The Guile Reference Manual}, i.e. the load paths are not
searched, so @var{script} must be an absolute path name. The
@code{init-fun} parameter supplies the name of an @dfn{initialization
@@ -2901,11 +2946,6 @@ Virtual Table: @code{(cons "result-count" result-count)}@*
Return the number of elements in the result set @var{resh}.
@end deffn
-@node Python
-@section The @command{python} module.
-@cindex Python
-@UNREVISED
-
@node Dico Scheme Primitives
@subsection Dico Scheme Primitives
@cindex strategy functions, Scheme
@@ -3205,6 +3245,11 @@ module initialization function:
Notice, that in this implementation @samp{close-db} callback was not
needed.
+@node Python
+@section The @command{python} module.
+@cindex Python
+@UNREVISED
+
@node Interface
@chapter Dico Module Interface
@UNREVISED
@@ -3431,7 +3476,7 @@ $ dico entdeckung
word @samp{entdeckung} using its default server name and database. The
default server name is read from the initialization file
(@pxref{Initialization File}). If it is not present, a predefined
-value specified at configuration time (@FIXME-pxref{Building}) is
+value specified at configuration time (@pxref{Default Server}) is
used. The default database is @samp{!}, which means ``search in all
available databases until a match is found, and then display all
matches in that database''.
@@ -3700,9 +3745,9 @@ dico> .open gnu.org.ua
If any or both of its arguments are absent, the @code{open} command
reuses the value supplied with its previous invocation, or, if it is
issued for the first time, the default values. The default for server
-name is @samp{gnu.org.ua}. It can be changed at configuration time,
-see @FIXME-ref{Building, DEFAULT_DICT_SERVER}. The default port
-number is 2628.
+name is @samp{gnu.org.ua} and the default port number is 2628. Both
+values can be changed at configuration time, see @ref{Default Server}
+for a detailed instruction.
Note that you are not required to issue this command. If it is not
given, @command{dico} will attempt to connect using its default
@@ -4585,11 +4630,11 @@ Print program version.
@node Reporting Bugs
@chapter How to Report a Bug
- Email bug reports to @email{bug-dico@@gnu.org.ua}. Please include a
-detailed description of the bug and information about the conditions
-under which it occurs, so we can reproduce it. To facilitate the
-task, the following list shows the basic set of information that is
-needed in order to find the bug:
+ Email bug reports to @email{bug-dico@@gnu.org} or
+@email{bug-dico@@gnu.org.ua}. Please include a detailed description
+of the bug and information about the conditions under which it occurs,
+so we can reproduce it. To facilitate the task, the following list
+shows the basic set of information that is needed in order to find the bug:
@itemize
@item Package version you use. The output of @command{dicod
diff --git a/doc/gendocs_template b/doc/gendocs_template
index 7e1465e..7f2a791 100755..100644
--- a/doc/gendocs_template
+++ b/doc/gendocs_template
@@ -4,7 +4,7 @@
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
-<title>%%TITLE%% - GNU Project - gray.gnu.org.ua</title>
+<title>%%TITLE%% - GNU Project - Free Software Foundation (FSF)</title>
<meta http-equiv="content-type" content='text/html; charset=utf-8' />
<link rel="stylesheet" type="text/css" href="/local/css/gnu.css" />
<link rev="made" href="mailto:gray@gnu.org.ua" />
@@ -104,7 +104,7 @@ Please send broken links and other corrections (or suggestions) to
</p>
<p>
-Copyright (C) 2005 Sergey Poznyakoff
+Copyright (C) 2005, 2008 Sergey Poznyakoff
<br />
Verbatim copying and distribution of this entire article is
permitted in any medium, provided this notice is preserved.

Return to:

Send suggestions and report system problems to the System administrator.