1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
|
.\" This manpage is copyright (C) 2009 أحمد المحمودي (Ahmed El-Mahmoudy)
.\" Based on dictdconfig manpage which is copyright (C) 1999-2000 Kirk Hilliard
.\" <kirk@debian.org>.
.\" This is free software, published under version 2 or (at your option)
.\" any later version of the GNU General Public License. You should
.\" have received a copy of the GNU General Public License with your
.\" Debian GNU/Linux system as /usr/share/common-licenses/GPL.
.\"
.TH DICODCONFIG 8 "April 5, 2009" "DEBIAN" "Debian User's Manual"
.SH NAME
dicodconfig \- write dicod database configuration section
.SH SYNOPSIS
.B dicodconfig
[\-hlovw]
[\-\-help]
[\-\-list]
[\-\-order]
[\-\-version]
[\-\-write]
.SH DESCRIPTION
.B dicodconfig
generates a complete
.B dicod
database configuration section for
available dictionary databases found in
.I /usr/share/dictd/
(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
are created.
.PP
Its output file
.I /var/lib/dicod/dictorg-db.list
may then be included from the
.B dicod
configuration file
.I /etc/dicod.conf
with an
``#include /var/lib/dicod/dictorg-db.list''
line.
See
.BR info dico
for an explanation of
.B dicod
configuration.
.PP
In Debian,
.B dicodconfig
is automatically invoked upon installation or removal of
dictionary database packages,
so most users will never need to invoke it by hand.
.SS DATABASE ORDER
The default order in which database entries are written is hard coded
into
.BR dicodconfig ,
but it may be overridden via the optional order override file
.IR /etc/dicod/dicod.order .
This may be desired because
.B dicod
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
.IR /usr/share/dictd/ .
.PP
.IR /etc/dicod/dicod.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.
.PP
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.
.PP
Entries without a leading / are relative to
.IR /usr/share/dictd/ .
.PP
Entries without a trailing / are basenames.
A dictionary database entry is generated if
.I <basename>.index
and
.I <basename>.dict.dz
or
.I <basename>.dict
are present.
.PP
Entries with a trailing / are directories.
A dictionary database entry is generated for each <name> where
.I <directory>/<name>.index
and
.I <directory>/<name>.dict.dz
or
.I <directory>/<name>.dict
are present.
.PP
The default order includes the directories
.I /usr/share/dictd/
,
.I /usr/share/dico/
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
.I /usr/share/dictd/
,
.I /usr/share/dico/
and for any other directory where local dictionary database might be
installed.
.PP
The \-o option may be used to make
.B dicodconfig
display the default order information along with the order override
information if
.I /etc/dicod/dicod.order
is present.
.SS 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
.I /dev/null
for both data and index. This allows dicod to start without error.
.SS DATABASE ALIASES
If an executable script named
.I /etc/dicod/dicodconfig.alias
exists, dicodconfig will filter database names through it. The script
can be bash, sed, perl, or whatever. Although
.I dico \-D
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
.I dico \-D
to display the database names in a reasonable format.
.SH OPTIONS
.TP
.I \-w, \-\-write
Write database section to
.IR /var/lib/dicod/dictorg-db.list .
.TP
.I \-l, \-\-list
List database section to standard out.
.TP
.I \-o, \-\-order
Display database order information.
.TP
.I \-h, \-\-help
Display a usage message and exit.
.TP
.I \-v, \-\-version
Display version information and exit.
.SH FILES
.TP
.I /var/lib/dicod/dictorg-db.list
Output of
.BR dicodconfig .
.TP
.I /etc/dicod.conf
.B dicod
configuration file which "includes"
.IR /var/lib/dicod/dictorg-db.list .
.TP
.I /etc/dicod/dicod.order
Optional
.B dicodconfig
order override file.
.SH SEE ALSO
dicod(8)
.SH BUGS
Older dictionary database packages did not automatically invoke
.B dicodconfig
upon installation and removal, so you may need to do so
manually (after which, you should restart dicod).
.SH AUTHOR
أحمد المحمودي (Ahmed El-Mahmoudy)
Based on
dictdconfig(8)
By Kirk Hilliard <kirk@debian.org>.
|
