generates a complete
database configuration section for
available dictionary databases found in
(or possibly elsewhere if an optional order override file is present).
If a dictionary database contains a <basename>.suffix and/or a
<basename>.word file, appropriate index_suffix and index_word entries
Its output file
may then be included from the
for an explanation of
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
but it may be overridden via the optional order override file
This may be desired because
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 include local dictionary
databases which may not necessarily reside in
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
Entries without a trailing / are basenames.
A dictionary database entry is generated if
Entries with a trailing / are directories.
A dictionary database entry is generated for each <name> where
The default order includes the directories
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
and for any other directory where local dictionary database might be
The -o option may be used to make
display the default order information along with the order override
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
for both data and index. This allows dicod to start without error.
If an executable script named
exists, dicodconfig will filter database names through it. The script
can be bash, sed, perl, or whatever. Although
will display database names of any length, names longer than 16
characters are displayed in a ragged format. Appropriate entries in
this alias file can be used to cause
to display the database names in a reasonable format.
Write database section to
List database section to standard out.
Display database order information.
Display a usage message and exit.
Display version information and exit.
configuration file which "includes"