Provided by: serpento_0.4.1ubuntu1_i386 bug

NAME

       dictdconfig - write serpento database configuration section

SYNOPSIS

       dictdconfig [-hlovw] [--help] [--list] [--order] [--version] [--write]

DESCRIPTION

       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.

   DATABASE ORDER
       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.

   DUMMY ENTRY
       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.

OPTIONS

       -w, --write
              Write database section to /var/lib/dictd/db.list.

       -l, --list
              List database section to standard out.

       -o, --order
              Display database order information.

       -h, --help
              Display a usage message and exit.

       -v, --version
              Display version information and exit.

FILES

       /var/lib/dictd/db.list
              Output of dictdconfig.

       /etc/serpento/config-dbs.py
              dictd       configuration       file       which      "includes"
              /var/lib/dictd/serpento.db.list.

       /etc/dictd.order
              Optional dictdconfig order override file.

SEE ALSO

       serpento(8), dictd(8)

BUGS

       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).

AUTHOR

       Kirk Hilliard <kirk@debian.org>.

       Modified       for       serpento       by       Radovan        Garabik
       <garabik@melkor.dnp.fmph.uniba.sk>

                               February 22, 2000                DICTDCONFIG(8)