Provided by: serpento_0.4.1ubuntu1_i386
dictdconfig - write serpento database configuration section
dictdconfig [-hlovw] [--help] [--list] [--order] [--version] [--write]
dictdconfig generates a complete serpento database configuration
section for available dictionary databases found in /usr/share/dictd/
(or possibly elsewhere if an optional order override file is present).
Its output file /var/lib/dictd/serpento.db.list may then be included
from the serpento configuration file /etc/serpento/config-dbs.py with
an ‘‘execfile("/var/lib/dictd/serpento.db.list")’’ line. See
serpento(8) for an explanation of serpento configuration.
dictdconfig is automatically invoked upon installation or removal of
dictionary database packages, so most users will never need to invoke
it by hand.
The default order in which database entries are written is hard coded
into dictdconfig, but it may be overridden via the optional order
override file /etc/dictd.order. This may be desired because serpento
returns definitions from dictionary databases in the order in which
they are listed in its configuration file. The order override file may
also be used to included local dictionary databases which may not
necessarily reside in /usr/share/dictd/.
/etc/dictd.order, if present, should be a whitespace separated list of
basenames and directories. It may also include comments starting with
# and extending to the end of the line.
Dictionary database entries will be generated only for those databases
found via basename and directory entries in the default order (or the
order override file, if present), and they will be generated in the
order in which these entries appear. No more than one dictionary
database entry of any given name will be generated.
Entries without a leading / are relative to /usr/share/dictd/.
Entries without a trailing / are basenames. A dictionary database
entry is generated if <basename>.index and <basename>.dict.dz or
<basename>.dict are present.
Entries with a trailing / are directories. A dictionary database entry
is generated for each <name> where <directory>/<name>.index and
<directory>/<name>.dict.dz or <directory>/<name>.dict are present.
The default order includes the directory /usr/share/dictd/ as its final
entry so that if a previously unknown dictionary database (one not
explicitly mentioned in the default order) is installed, its dictionary
database entry will still be generated. An order override file should
also use this technique, both for /usr/share/dictd/ and for any other
directory where local dictionary database might be installed.
The -o option may be used to make dictdconfig display the default order
information along with the order override information if
/etc/dictd.order is present.
If no dictionary databases are found (via basename or directory entries
in the default order or the order override file), a dummy dictionary
database entry will be generated with /dev/null for both data and
index. This allows dictd to start without error.
Write database section to /var/lib/dictd/db.list.
List database section to standard out.
Display database order information.
Display a usage message and exit.
Display version information and exit.
Output of dictdconfig.
dictd configuration file which "includes"
Optional dictdconfig order override file.
Older dictionary database packages did not automatically invoke
dictdconfig upon installation and removal, so you may need to do so
manually (after which, you should restart serpento).
Kirk Hilliard <email@example.com>.
Modified for serpento by Radovan Garabik
February 22, 2000 DICTDCONFIG(8)