Please find, for review, the debconf templates and packages descriptions for the dictd source package. This review will last from Thursday, March 19, 2009 to Sunday, March 29, 2009. Please send reviews as unified diffs (diff -u) against the original files. Comments about your proposed changes will be appreciated. Your review should be sent as an answer to this mail. When appropriate, I will send intermediate requests for review, with "[RFRn]" (n>=2) as a subject tag. When we will reach a consensus, I send a "Last Chance For Comments" mail with "[LCFC]" as a subject tag. Finally, the reviewed templates will be sent to the package maintainer as a bug report, and a mail will be sent to this list with "[BTS]" as a subject tag. Rationale: --- dictd.old/debian/dictd.templates 2009-03-11 09:14:14.179576696 +0100 +++ dictd/debian/dictd.templates 2009-03-15 08:19:38.257524056 +0100 @@ -2,8 +2,8 @@ Type: select __Choices: daemon, inetd, disabled Default: daemon -_Description: How do you want to run dictd? +_Description: Method for running dictd: Select|mutliselect templates should avoid the interrogative form, as a matter of overall consistency. The dictd server can be run either as a stand-alone daemon or from inetd. You can also disable it entirely. . - Running in the daemon mode is the recommended approach. + It is recommended to run it as a daemon. Less clumky sentence... --- dictd.old/debian/control 2009-03-11 09:14:14.195576236 +0100 +++ dictd/debian/control 2009-03-19 07:26:04.902422396 +0100 @@ -8,23 +8,21 @@ Package: dictd Architecture: any -Description: Dictionary Server - dictd is a TCP based server that allows a client to access dictionary +Description: dictionary server Avoid capitals as per Developer's Reference recommendations + This package provides a TCP-based server that allows a client to access dictionary definitions from a set of natural language dictionary databases. Common trick to avoid leading lowercase in a sentence. use a dash in "TCP-based" . - Many dictionary databases have been packaged for Debian. They are - discussed in more detail in the file - /usr/share/doc/dictd/README.Debian.gz + Many dictionary databases have been packaged for use with dictd. They are + described in the /usr/share/doc/dictd/README.Debian.gz file. Unbranding (drop "Debian"....the package is also used in derivatives) . Either dict-gcide or dict-wn is essential for a useful English language dictionary server. It is strongly recommended that both be installed. If you are interested in computer terminology, it is - recommended that one or more of dict-jargon, dict-foldoc, and - dict-vera also be installed. + recommended to install at least dict-jargon, dict-foldoc, or + dict-vera. My own view of it...not sure of that's better . - The client program, dict, is packaged in dict*.deb If you are - running a server, you will want the client for all machines in your - network, and for testing server operations. + The client program, dict, is packaged separately and is needed on all + machines that will use the server. "separately" does not make assumption on the package naming. This, just in case something changes in the future and nobody thinks about changing the description (which is something we never change, don't we?) Depends: ${shlibs:Depends}, ${misc:Depends}, netbase, adduser, dictzip (>= ${source:Upstream-Version}), lsb-base (>= 3.1), ucf (>= 3), update-inetd Recommends: dict | dict-client Suggests: dict-gcide | dictd-dictionary, dict-wn, dict-jargon, dict-foldoc @@ -33,22 +31,22 @@ Package: dict Architecture: any -Description: Dictionary Client - dict is the client that queries the dictd server. Since it is TCP - based, it can access servers on the local host, on a local network, - or on the Internet. +Description: dictionary client + This package provides a client application to query a dictd server. + The client-server protocol is TCP-based; the server may then be local or + accessed through the network. Simpler sentence? . The DICT Development Group maintains several public servers which can be accessed from any machine connected to the Internet. The default - configuration is to query one of these servers first, but this may be + configuration is to query one of these servers first. This may be changed in the configuration file /etc/dictd/dict.conf. Simplify the sentences by shortening them. . Queries may be customized by numerous command line options, including specifying the database(s) to be queried and the search strategy to be used. . - dict includes dictl, which simplifies using utf-8 encoded dictionaries - with terminals that do not support utf-8. + This package also provides dictl, which allows using UTF-8 encoded dictionaries + with terminals that do not support UTF-8. Use the proper spelling of UTF-8 Depends: ${shlibs:Depends}, ${misc:Depends}, netbase, recode Recommends: m4, gawk Suggests: dictd | dict-server @@ -56,8 +54,8 @@ Package: dictzip Architecture: any -Description: Compression utility for dictionary databases - dictzip compresses files using the gzip(1) algorithm (LZ77) in a +Description: compression utility for dictionary databases uncapitalisation + This package provides a utility to compress dictionary database using the gzip(1) algorithm (LZ77) in a manner which is completely compatible with the gzip file format. An extension to the gzip file format allows for random access to chunks of about 57kb without the overhead of decompressing the entire file. Again the "this package provides" trick @@ -70,11 +68,11 @@ Package: dictfmt Section: utils Architecture: any -Description: Utility to format a file for use by the dictd server - dictfmt converts an input file to a dictionary database that conforms - to the DICT protocol, and creates a corresponding index file. +Description: utility to format a file for use by a dictd server "a" dictd server...there are many of them in the world..:-) + This package provides dictfmt. This utility can convert an input file to a dictionary database that conforms + to the DICT protocol, and create a corresponding index file. . - This package also includes dictunformat which creates a raw database - from dictionary index and a dictionary database. + The package also provides dictunformat which creates a raw database + from a dictionary index and a dictionary database. s/includes/provides for consistency Depends: ${shlibs:Depends}, ${misc:Depends}, gawk Recommends: dictzip --
Template: dictd/run_mode Type: select __Choices: daemon, inetd, disabled Default: daemon _Description: Method for running dictd: The dictd server can be run either as a stand-alone daemon or from inetd. You can also disable it entirely. . It is recommended to run it as a daemon.
--- dictd.old/debian/dictd.templates 2009-03-11 09:14:14.179576696 +0100 +++ dictd/debian/dictd.templates 2009-03-15 08:19:38.257524056 +0100 @@ -2,8 +2,8 @@ Type: select __Choices: daemon, inetd, disabled Default: daemon -_Description: How do you want to run dictd? +_Description: Method for running dictd: The dictd server can be run either as a stand-alone daemon or from inetd. You can also disable it entirely. . - Running in the daemon mode is the recommended approach. + It is recommended to run it as a daemon. --- dictd.old/debian/control 2009-03-11 09:14:14.195576236 +0100 +++ dictd/debian/control 2009-03-19 07:26:04.902422396 +0100 @@ -8,23 +8,21 @@ Package: dictd Architecture: any -Description: Dictionary Server - dictd is a TCP based server that allows a client to access dictionary +Description: dictionary server + This package provides a TCP-based server that allows a client to access dictionary definitions from a set of natural language dictionary databases. . - Many dictionary databases have been packaged for Debian. They are - discussed in more detail in the file - /usr/share/doc/dictd/README.Debian.gz + Many dictionary databases have been packaged for use with dictd. They are + described in the /usr/share/doc/dictd/README.Debian.gz file. . Either dict-gcide or dict-wn is essential for a useful English language dictionary server. It is strongly recommended that both be installed. If you are interested in computer terminology, it is - recommended that one or more of dict-jargon, dict-foldoc, and - dict-vera also be installed. + recommended to install at least dict-jargon, dict-foldoc, or + dict-vera. . - The client program, dict, is packaged in dict*.deb If you are - running a server, you will want the client for all machines in your - network, and for testing server operations. + The client program, dict, is packaged separately and is needed on all + machines that will use the server. Depends: ${shlibs:Depends}, ${misc:Depends}, netbase, adduser, dictzip (>= ${source:Upstream-Version}), lsb-base (>= 3.1), ucf (>= 3), update-inetd Recommends: dict | dict-client Suggests: dict-gcide | dictd-dictionary, dict-wn, dict-jargon, dict-foldoc @@ -33,22 +31,22 @@ Package: dict Architecture: any -Description: Dictionary Client - dict is the client that queries the dictd server. Since it is TCP - based, it can access servers on the local host, on a local network, - or on the Internet. +Description: dictionary client + This package provides a client application to query a dictd server. + The client-server protocol is TCP-based; the server may then be local or + accessed through the network. . The DICT Development Group maintains several public servers which can be accessed from any machine connected to the Internet. The default - configuration is to query one of these servers first, but this may be + configuration is to query one of these servers first. This may be changed in the configuration file /etc/dictd/dict.conf. . Queries may be customized by numerous command line options, including specifying the database(s) to be queried and the search strategy to be used. . - dict includes dictl, which simplifies using utf-8 encoded dictionaries - with terminals that do not support utf-8. + This package also provides dictl, which allows using UTF-8 encoded dictionaries + with terminals that do not support UTF-8. Depends: ${shlibs:Depends}, ${misc:Depends}, netbase, recode Recommends: m4, gawk Suggests: dictd | dict-server @@ -56,8 +54,8 @@ Package: dictzip Architecture: any -Description: Compression utility for dictionary databases - dictzip compresses files using the gzip(1) algorithm (LZ77) in a +Description: compression utility for dictionary databases + This package provides a utility to compress dictionary database using the gzip(1) algorithm (LZ77) in a manner which is completely compatible with the gzip file format. An extension to the gzip file format allows for random access to chunks of about 57kb without the overhead of decompressing the entire file. @@ -70,11 +68,11 @@ Package: dictfmt Section: utils Architecture: any -Description: Utility to format a file for use by the dictd server - dictfmt converts an input file to a dictionary database that conforms - to the DICT protocol, and creates a corresponding index file. +Description: utility to format a file for use by a dictd server + This package provides dictfmt. This utility can convert an input file to a dictionary database that conforms + to the DICT protocol, and create a corresponding index file. . - This package also includes dictunformat which creates a raw database - from dictionary index and a dictionary database. + The package also providesdictunformat which creates a raw database + from a dictionary index and a dictionary database. Depends: ${shlibs:Depends}, ${misc:Depends}, gawk Recommends: dictzip
Source: dictd Section: text Priority: optional Maintainer: Robert Luberda <robert@debian.org> Build-Depends: flex, bison, zlib1g-dev, libltdl3-dev, autotools-dev, quilt (>= 0.45), debhelper (>= 7), libtool, libmaa-dev Standards-Version: 3.8.0 Homepage: http://sourceforge.net/projects/dict/ Package: dictd Architecture: any Description: dictionary server This package provides a TCP-based server that allows a client to access dictionary definitions from a set of natural language dictionary databases. . Many dictionary databases have been packaged for use with dictd. They are described in the /usr/share/doc/dictd/README.Debian.gz file. . Either dict-gcide or dict-wn is essential for a useful English language dictionary server. It is strongly recommended that both be installed. If you are interested in computer terminology, it is recommended to install at least dict-jargon, dict-foldoc, or dict-vera. . The client program, dict, is packaged separately and is needed on all machines that will use the server. Depends: ${shlibs:Depends}, ${misc:Depends}, netbase, adduser, dictzip (>= ${source:Upstream-Version}), lsb-base (>= 3.1), ucf (>= 3), update-inetd Recommends: dict | dict-client Suggests: dict-gcide | dictd-dictionary, dict-wn, dict-jargon, dict-foldoc Provides: dict-server Conflicts: dict-server Package: dict Architecture: any Description: dictionary client This package provides a client application to query a dictd server. The client-server protocol is TCP-based; the server may then be local or accessed through the network. . The DICT Development Group maintains several public servers which can be accessed from any machine connected to the Internet. The default configuration is to query one of these servers first. This may be changed in the configuration file /etc/dictd/dict.conf. . Queries may be customized by numerous command line options, including specifying the database(s) to be queried and the search strategy to be used. . This package also provides dictl, which allows using UTF-8 encoded dictionaries with terminals that do not support UTF-8. Depends: ${shlibs:Depends}, ${misc:Depends}, netbase, recode Recommends: m4, gawk Suggests: dictd | dict-server Provides: dict-client Package: dictzip Architecture: any Description: compression utility for dictionary databases This package provides a utility to compress dictionary database using the gzip(1) algorithm (LZ77) in a manner which is completely compatible with the gzip file format. An extension to the gzip file format allows for random access to chunks of about 57kb without the overhead of decompressing the entire file. . This package also includes dictunzip to decompress dictzipped files and dictzcat for viewing dictzipped files. Depends: ${shlibs:Depends}, ${misc:Depends} Replaces: dictd (<< 1.7.1-1) Package: dictfmt Section: utils Architecture: any Description: utility to format a file for use by a dictd server This package provides dictfmt. This utility can convert an input file to a dictionary database that conforms to the DICT protocol, and create a corresponding index file. . The package also provides dictunformat which creates a raw database from a dictionary index and a dictionary database. Depends: ${shlibs:Depends}, ${misc:Depends}, gawk Recommends: dictzip
Attachment:
signature.asc
Description: Digital signature