— part of check-in
on branch trunk
— update NEWS
# -*- org -*-
* zeptodb news
** v3.0 (12 June 2016)
This is a major update. Please note that there have been significant
changes to the interface via several changes to the options.
*** Removed support for Kyoto Cabinet
In order to be able to better long-term support the program, the
decision was made to only support one DBM library.
*** Overhaul of options
All zeptodb programs now support a set of common options: --mmap-size,
--cache-size, --block-size, --no-mmap, and --no-lock (in addition to
the usual help, usage, version and verbose options). These options
control how the database is opened. Please note that the
"--num-buckets" option for zdbc has been removed since it was only
appropriate for Kyoto Cabinet and was a misnomer for GDBM (it's
effectively been replaced by --cache-size). The --sync option has
also been added for commands that write changes to the database.
Please see the documentation for a full explanation of these options.
*** zdbc always creates a new database
zdbc now overwrites a database if it's called on an existing file.
** v2.0.2b (17 November 2013)
This release simply fixes some problems in the documentation of
** v2.0.2 (17 November 2013)
This is another bug-fix release.
*** Several memory bugs fixed
There were some memory bugs in the previous version. Everything
should be fixed now, according to valgrind output and such.
*** More gnulib modules added
More gnulib modules have been added and some extra precaution was
taken to ensure that zeptodb builds properly on as many POSIX-like
systems as possible.
*** System tests are provided
The distribution now includes some system tests to verify that the
zeptodb binaries are working properly. You can run them via the
"check" make target:
$ make all
$ make check
*** Packaging is now done via swbis
From now on, zeptodb will be packaged using swbis
(http://www.gnu.org/software/swbis). The usual source distribution,
zeptodb-2.0.2.tar.gz, now also contains checksums (md5, sha1 and
sha512) as well as a GPG signature. You can verify the package using
swverify from the swbis package:
$ swverify -d @- <zeptodb-2.0.2.tar.gz
swverify: Archive digest: md5 OK (Good)
swverify: Archive digest: sha1 OK (Good)
swverify: Archive size: OK (Good)
swverify: Archive digest: sha512 OK (Good)
gpg: Signature made Sun 17 Nov 2013 03:16:57 PM CET using RSA key ID EB7AB74D
gpg: Good signature from "Brandon Invergo (GNU) <email@example.com>"
gpg: aka "Brandon Invergo <firstname.lastname@example.org>"
gpg: WARNING: This key is not certified with a trusted signature!
gpg: There is no indication that the signature belongs to the owner.
Primary key fingerprint: E675 19DB 1E30 6FA8 266D 08BA 046E DEE6 EB7A B74D
I also provide two packages that are compliant with the POSIX
packaging standard that swbis implements, one is a source distribution
(zeptodb-2.0.2-src.sw.tar.gz) and the other is a binary (x86_64
GNU/Linux) distribution (zeptodb-2.0.2-x86_64.sw.tar.gz). Both can be
installed via the swbis tool swinstall. The source distribution is
automatically configured and built after it is installed with
swinstall. The built binaries can then be installed via the swconfig
$ swinstall -s :zeptodb-2.0.2-src.sw.tar.gz @/usr/local
[configure and make build output]
$ swconfig zeptodb @/usr/local
[make install output]
The x86_64 binary distribution will require up-to-date GNU libc (2.18)
and GDBM (1.10) libraries. The binaries will be installed in the
proper places at the prefix of your choice when you run swinstall.
For example, to install to /usr/local:
$ swinstall -s :zeptodb-2.0.2-x86_64.sw.tar.gz @/usr/local
Why do this? It's unfeasible for me to provide packages for all the
different packaging systems out there. If I'm only going to provide
one, it had better be standards-compliant. It should be relatively
simple to convert the swbis packages to some other format. OK, so I
may be the only person in the world other than the swbis developer who
is using this system, but it's to be hoped that others will join in.
At the very least, building standard source distributions with swbis
is handy for including in-line all the checksums and signatures right
into the package.
** v2.0.1 (04 July 2013)
*** Bugfix release
This release just fixes a couple bugs that popped up when running
zeptodb on an ancient system.
** v2.0 (03 July 2013
*** Kyoto Cabinet back-end is now available
At compile time, you can now opt to use the Kyoto Cabinet DBM library
instead of the GDBM library. Note that any databases created with
the GDBM library will *not* be accessible with the Kyoto Cabinet
*** Database creation now has a dedicated program
Previously, zeptodb databases were created automatically upon storing
the first value in them. Now, there is the zdbc tool dedicated to
creating new databases. This tool allows you to control some
parameters of the database, namely the number of hash buckets and the
size of the memory-mapped region that it uses. As a result, zdbs will
no longer automatically create new databases.
*** New --verbose mode
All tools now have a --verbose option, which causes them to display
more information while they work. This is particularly handy when
you are working with thousands of entries.
*** General code refactoring
To cleanly handle the two DBM back-ends, the code was significantly
refactored, making it easier to read and edit.
** v1.1 (10 June 2013)
*** zeptodb now uses gnulib for portability
zeptodb makes use of some handy functions from the GNU C Library
which may not be present on all systems. To make up for that, it now
provides some gnulib modules which provide the missing functionality
on such systems.
** v1.0 (07 June 2013)
*** First release!