diff options
author | Sergey Poznyakoff <gray@gnu.org.ua> | 2009-03-29 15:15:45 +0300 |
---|---|---|
committer | Sergey Poznyakoff <gray@gnu.org.ua> | 2009-03-29 16:00:06 +0300 |
commit | 2f9243a64f2c4de97da6b8d8e041c214a7dc302a (patch) | |
tree | e63f0c514bba64743311adcb5e509b976bfa213a | |
parent | 081142efc7b74babe251496d2487c8faf99a8bb3 (diff) | |
download | dico-2f9243a64f2c4de97da6b8d8e041c214a7dc302a.tar.gz dico-2f9243a64f2c4de97da6b8d8e041c214a7dc302a.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.am | 26 | ||||
-rw-r--r-- | NEWS | 4 | ||||
-rw-r--r-- | README | 18 | ||||
-rw-r--r-- | configure.ac | 2 | ||||
-rw-r--r-- | doc/dico.texi | 81 | ||||
-rw-r--r--[-rwxr-xr-x] | doc/gendocs_template | 4 |
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: @@ -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. @@ -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. |