From e3866a39dd09ebee2c891228d766661ce14d09c7 Mon Sep 17 00:00:00 2001 From: Sergey Poznyakoff Date: Mon, 11 Oct 2021 20:42:15 +0300 Subject: Improve documentation --- NEWS | 29 ++++++++++++++++++++++++++++- doc/gdbm.texi | 21 +++++++++++++++++++++ 2 files changed, 49 insertions(+), 1 deletion(-) diff --git a/NEWS b/NEWS index 3032e6c..097dd36 100644 --- a/NEWS +++ b/NEWS @@ -1,10 +1,37 @@ -GNU dbm NEWS -- history of user-visible changes. 2021-09-03 +GNU dbm NEWS -- history of user-visible changes. 2021-10-11 Copyright (C) 1990-2021 Free Software Foundation, Inc. See the end of file for copying conditions. Please send gdbm bug reports to . Version 1.21.90 (git) + +* Fix file header validation + +* Fix key verification in sequential access + +* Fix testing with DejaGNU 1.6.3 + +* Fix stack overflow in print_usage + +* Fix a leak of avail entry on pushing a new avail block + +The leak would occur if the original avail table had odd number of entries. + +* New gdbmtool variables: errorexit, errormask, trace, timing + +"Errorexit" and "errormask" control which GDBM errors would cause the +program termination and emitting a diagnostic message, +correspondingly. Both variables are comma-delimited lists of error +codes. + +The "trace" variable enables tracing of the gdbmtool commands. + +The "timing" variable, when set, instructs gdbmtool to print time +spent in each command it runs. + +* New gdbmtool options: -t (--trace), and -T (--timing) + Version 1.21, 2021-09-02 diff --git a/doc/gdbm.texi b/doc/gdbm.texi index 9a5b676..0f739e1 100644 --- a/doc/gdbm.texi +++ b/doc/gdbm.texi @@ -3165,6 +3165,27 @@ A string used to delimit array items when printing a structured datum Default is @samp{,} (a comma). This variable cannot be unset. @end deftypevr +@deftypevr {gdbmtool variable} string errorexit +@deftypevrx {gdbmtool variable} bool errorexit +Comma-delimited list of @code{gdbm} error codes which cause program +termination. Error codes are specified via their canonical names +(@pxref{Error codes}). The @code{GDBM_} prefix can be omitted. Code +name comparison is case-insensitive. Each error code can optionally +be prefixed with minus sign, to indicate that it should be removed +from the resulting list, or with plus sign (which is allowed for +symmetry). A special code @samp{all} stands for all available error codes. + +In boolean context, the @code{true} value is equivalent to @samp{all}, +and @code{false} (i.e. variable unset) is equivalent to @samp{-all}. +@end deftypevr + +@deftypevr {gdbmtool variable} string errormask +@deftypevrx {gdbmtool variable} bool errormask +Comma-delimited list of @code{gdbm} error codes which are masked, i.e. +which won't trigger a diagnostic message if they occur. The syntax is +the same as described for @code{errorexit}. +@end deftypevr + @deftypevr {gdbmtool variable} string pager The name and command line of the pager program to pipe output to. This program is used in interactive mode when the estimated number of -- cgit v1.2.1