Dico
	GNU Dictionary Server	Sergey Poznyakoff

• Main
• Modules
• Dicoweb
• Downloads
• Documentation
• The Team

GNU Dico Manual (split by section):

Section:

Chapter:

Doc:

?

6.1 Single Query Mode

The simplest way to use dico utility is to invoke it with a word as an argument, e.g.:

$ dico entdeckung

In the example above, the utility will search definitions of the word ‘entdeckung’ using its default server name and database. The default server name is read from the initialization file (see section Initialization File). If it is not present, a predefined value specified at configuration time (see section Default Server) is used. The default database is ‘!’, which means “search in all available databases until a match is found, and then display all matches in that database”.

There are two ways to change these defaults. First, you can use command line options. Secondly, you can use a DICT URL. Which method to use depends on your preferences. Both methods provide the same functionality for querying word definitions. However, command line options allow to query additional data from the server, which is impossible using URLs.

6.1.1 Dico Command Line Options

To connect to a particular dictionary server, use ‘--host’ option, for example:

$ dico --host dico.org entdeckung

To search in a particular database, use ‘--database’ (‘-d’) option. For example, to display definitions from all databases:

$ dico --database '*' entdeckung

Note single quotes around the asterisk.

To get a list of databases offered by the server, use ‘--dbs’ (‘-D’) option. In this case you may not give any non-option arguments. For example:

$ dico --dbs

If you wish to get a list of matches, instead of definitions, use ‘--match’ (‘-m’) option. For example, the following invocation will display all matches from all the databases:

$ dico --database '*' --match entdeckung

The match mode uses ‘.’ strategy by default (see section strategy), which means a server-dependent default strategy, which suits best for interactive spell checking. To select another strategy, use ‘--strategy’ (‘-s’) option.

If the remote server supports ‘xlev’ experimental capability (see section XLEV, you may use ‘--levdist’ (‘--levenshtein-distance’) option to set maximum Levenshtein distance, for example:

$ dico --levdist 2 --match entdeckung

Note that setting the distance too high is impractical and may imply unnecessary strain on the server.

To get a list of available matching strategies, with descriptions, use the ‘--strategies’ (‘-S’) option.

6.1.2 DICT URL

Another way to specify data for a query is by using URL, instead of a word to search, as in the example below:

$ dico dict://gnu.org.ua/d:entdeckung

A DICT URL consists of the following parts:

dict://user;pass@host:port/d:word:database:n
dict://user;pass@host:port/m:word:database:strat:n

The ‘/d’ syntax requests the definition of word, whereas the ‘/m’ syntax queries for matches, and is similar to ‘--match’ option. Some or all of ‘user;pass@’, ‘:port’, database, strat, and and n may be omitted. The meaning of all URL parts and their default values (if appropriate) are explained in the table below:

user

User name to use in authentication. Similar to ‘--user’ option. If user is omitted and cannot be retrieved by other means, no authentication is performed. See section Autologin, for a detailed description of authentication procedure and sources which are used to obtain authentication credentials.

pass

A shared key (password) for that user. This part is similar to ‘--key’ command line option.

For compatibility with other URLs, dico allows to delimit user and pass with a colon (‘:’), instead of semicolon.

If user is given, but pass is not, dico will ask you to supply a password interactively (see section Autologin).

host

Host name or IP address of the server to query. Same as ‘--host’ command line option.

port

Port number or service name (from ‘/etc/services’). If it is not present, the default of 2628 is used.

Same as ‘--port’ command line option.

word

The word to look for.

database

The database to search in. If not given, ‘!’ is assumed.

Same as ‘--database’ command line option.

strat

The matching strategy to use. If omitted, ‘.’ is assumed.

Same as ‘--strategy’ command line option.

n

Extract and display the nth definition of the word. If omitted, all definitions are displayed.

There is no command line option equivalent for this parameter, because it is used rarely.

Trailing colons may be omitted. For example, the following URLs might specify definitions or matches:

dict://dict.org/d:shortcake:
dict://dict.org/d:shortcake:*
dict://dict.org/d:shortcake:wordnet:
dict://dict.org/d:shortcake:wordnet:1
dict://dict.org/d:abcdefgh
dict://dict.org/d:sun
dict://dict.org/d:sun::1
dict://dict.org/m:sun
dict://dict.org/m:sun::soundex
dict://dict.org/m:sun:wordnet::1
dict://dict.org/m:sun::soundex:1
dict://dict.org/m:sun:::

GNU Dico Manual (split by section):

Section:

Chapter:

Doc:

?