Please find, for review, the debconf templates and packages descriptions fo=
r the hesiod source package.
This review will last from Wednesday, November 07, 2007 to Saturday, Novemb=
er 17, 2007.
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>=3D2) 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:
--- ../hesiod.old/debian/libhesiod0.templates 2007-10-25 20:43:02.680900129=
+0000
+++ debian/libhesiod0.templates 2007-10-29 06:40:39.570454947 +0000
@@ -2,26 +2,28 @@
Type: string
Default: .athena.mit.edu
_Description: Hesiod domain for searches:
- Hesiod looks up keys using the standard Domain Name System. Enter the
- right-hand side of the domain name to do searches in. This name should
- begin with a ".".
+ Hesiod looks up keys using the standard Domain Name System. Please enter =
the
+ rightmost part of the domain name to do searches in. This name should
+ begin with a '.' character.
Remove double spaces (an overall consistency we try to achieve, even
if using double spacing after sentence dots is not 'wrong'.
Use "please enter" (again, consistency among packages)
s/right-hand side/rightmost part: I feel this more correct but native
speakers may correct me....
Avoid the strange ".". sequence by using the word "character".
=20
Template: hesiod/lhs
Type: string
Default: .ns
_Description: Hesiod prefix for searches:
- Hesiod lookups generally happen in a subdomain of the main domain. Enter
- the name of the subdomain here. This name should begin with a ".". At
- most sites, this entry should be ".ns".
+ Hesiod lookups generally happen in a subdomain of the main domain. Please=
enter
+ the name of the subdomain. This name should begin with a '.' character. T=
his
+ entry is '.ns' at many sites.
About the same changes
=20
Template: hesiod/classes
Type: string
Default: IN,HS
_Description: DNS class search order:
- Hesiod looks up names using DNS TXT records. In addition to using the
+ Hesiod looks up names using DNS TXT records. In addition to using the
standard IN DNS class for Internet names, it also uses by default the
- special HS class. You can change the class search order here, or leave
- out IN or HS if you want to. Don't insert extra spaces in the value. The
- default search path is "IN,HS" to search both classes. At some sites where
- older hesiod installations are still in use, you may need to specify
- "HS,IN" instead.
+ special HS class.
+ .
+ Please enter the class search order (the default value is suitable for
+ most sites). There should be no spaces in this search order value.
Splitted and reworded paragraph. More neutral wording, specifically to
avoid "here". Splitting is an attempt to make the request for no
spaces more proeminent.
+ .
+ Sites using
+ older Hesiod installations may need to use the 'HS,IN' search order.
Splitted for about the same reasons and, again, more neutral wording.
--- ../hesiod.old/debian/control 2007-10-25 20:43:02.680900129 +0000
+++ debian/control 2007-10-29 06:43:15.562474975 +0000
@@ -9,30 +9,39 @@
Architecture: any
Section: utils
Depends: ${shlibs:Depends}
-Description: Utilities for Project Athena's service name resolution protoc=
ol
+Description: Project Athena's service name resolution protocol - utilities
Use the common "generic description - specific description" style
Hesiod is a name service library that can provide general name service
- for a variety of applications. It is derived from BIND, the Berkeley
+ for a variety of applications. It is derived from BIND, the Berkeley
Internet Name Daemon, and leverages the existing DNS infrastructure of a
- network. It is used on a number of university networks, including MIT
+ network. It is used on a number of university networks, including MIT
and Iowa State University.
Drop double spacing
.
- If you will not be using this system on a network that already uses
- Hesiod, you probably do not need this package.
+ This package is only useful on networks that already use
+ Hesiod.
Neutral wording.
=20
Package: libhesiod0
Architecture: any
Section: libs
Depends: ${shlibs:Depends}, ${misc:Depends}
-Description: Libraries for hesiod, a service name resolution protocol
- This package contains the shared library for hesiod,
- the Project Athena service name resolution protocol used at MIT and
- elsewhere.
+Description: Project Athena's service name resolution protocol - libraries
+ Hesiod is a name service library that can provide general name service
+ for a variety of applications. It is derived from BIND, the Berkeley
+ Internet Name Daemon, and leverages the existing DNS infrastructure of a
+ network. It is used on a number of university networks, including MIT
+ and Iowa State University.
+ .
+ This package contains Hesiod's shared library.
Re-use the generic description paragraph. As a consequene, the
specific paragraph is very simple.
=20
Package: libhesiod-dev
Architecture: any
Section: devel
Depends: libhesiod0
+Description: Project Athena's service name resolution protocol - developme=
nt files
-Description: Dev libraries for hesiod, a service name resolution protocol
- This package contains the include files and static library for hesiod,
- the Project Athena service name resolution protocol used at MIT and
- elsewhere.
+ Hesiod is a name service library that can provide general name service
+ for a variety of applications. It is derived from BIND, the Berkeley
+ Internet Name Daemon, and leverages the existing DNS infrastructure of a
+ network. It is used on a number of university networks, including MIT
+ and Iowa State University.
+ .
+ This package contains Hesiod's include files and static library.
Same changes.
Template: hesiod/rhs Type: string Default: .athena.mit.edu _Description: Hesiod domain for searches: Hesiod looks up keys using the standard Domain Name System. Please enter the rightmost part of the domain name to do searches in. This name should begin with a '.' character. Template: hesiod/lhs Type: string Default: .ns _Description: Hesiod prefix for searches: Hesiod lookups generally happen in a subdomain of the main domain. Please enter the name of the subdomain. This name should begin with a '.' character. This entry is '.ns' at many sites. Template: hesiod/classes Type: string Default: IN,HS _Description: DNS class search order: Hesiod looks up names using DNS TXT records. In addition to using the standard IN DNS class for Internet names, it also uses by default the special HS class. . Please enter the class search order (the default value is suitable for most sites). There should be no spaces in this search order value. . Sites using older Hesiod installations may need to use the 'HS,IN' search order.
--- ../hesiod.old/debian/libhesiod0.templates 2007-10-25 20:43:02.680900129 +0000
+++ debian/libhesiod0.templates 2007-10-29 06:40:39.570454947 +0000
@@ -2,26 +2,28 @@
Type: string
Default: .athena.mit.edu
_Description: Hesiod domain for searches:
- Hesiod looks up keys using the standard Domain Name System. Enter the
- right-hand side of the domain name to do searches in. This name should
- begin with a ".".
+ Hesiod looks up keys using the standard Domain Name System. Please enter the
+ rightmost part of the domain name to do searches in. This name should
+ begin with a '.' character.
Template: hesiod/lhs
Type: string
Default: .ns
_Description: Hesiod prefix for searches:
- Hesiod lookups generally happen in a subdomain of the main domain. Enter
- the name of the subdomain here. This name should begin with a ".". At
- most sites, this entry should be ".ns".
+ Hesiod lookups generally happen in a subdomain of the main domain. Please enter
+ the name of the subdomain. This name should begin with a '.' character. This
+ entry is '.ns' at many sites.
Template: hesiod/classes
Type: string
Default: IN,HS
_Description: DNS class search order:
- Hesiod looks up names using DNS TXT records. In addition to using the
+ Hesiod looks up names using DNS TXT records. In addition to using the
standard IN DNS class for Internet names, it also uses by default the
- special HS class. You can change the class search order here, or leave
- out IN or HS if you want to. Don't insert extra spaces in the value. The
- default search path is "IN,HS" to search both classes. At some sites where
- older hesiod installations are still in use, you may need to specify
- "HS,IN" instead.
+ special HS class.
+ .
+ Please enter the class search order (the default value is suitable for
+ most sites). There should be no spaces in this search order value.
+ .
+ Sites using
+ older Hesiod installations may need to use the 'HS,IN' search order.
--- ../hesiod.old/debian/control 2007-10-25 20:43:02.680900129 +0000
+++ debian/control 2007-11-07 05:55:49.266800472 +0000
@@ -9,30 +9,38 @@
Architecture: any
Section: utils
Depends: ${shlibs:Depends}
-Description: Utilities for Project Athena's service name resolution protocol
+Description: Project Athena's service name resolution protocol - utilities
Hesiod is a name service library that can provide general name service
- for a variety of applications. It is derived from BIND, the Berkeley
+ for a variety of applications. It is derived from BIND, the Berkeley
Internet Name Daemon, and leverages the existing DNS infrastructure of a
- network. It is used on a number of university networks, including MIT
+ network. It is used on a number of university networks, including MIT
and Iowa State University.
.
- If you will not be using this system on a network that already uses
- Hesiod, you probably do not need this package.
+ This package is only useful on networks that already use
+ Hesiod.
Package: libhesiod0
Architecture: any
Section: libs
Depends: ${shlibs:Depends}, ${misc:Depends}
-Description: Libraries for hesiod, a service name resolution protocol
- This package contains the shared library for hesiod,
- the Project Athena service name resolution protocol used at MIT and
- elsewhere.
+Description: Project Athena's service name resolution protocol - libraries
+ Hesiod is a name service library that can provide general name service
+ for a variety of applications. It is derived from BIND, the Berkeley
+ Internet Name Daemon, and leverages the existing DNS infrastructure of a
+ network. It is used on a number of university networks, including MIT
+ and Iowa State University.
+ .
+ This package contains Hesiod's shared library.
Package: libhesiod-dev
Architecture: any
Section: devel
Depends: libhesiod0
-Description: Dev libraries for hesiod, a service name resolution protocol
- This package contains the include files and static library for hesiod,
- the Project Athena service name resolution protocol used at MIT and
- elsewhere.
+Description: Project Athena's service name resolution protocol - development files
+ Hesiod is a name service library that can provide general name service
+ for a variety of applications. It is derived from BIND, the Berkeley
+ Internet Name Daemon, and leverages the existing DNS infrastructure of a
+ network. It is used on a number of university networks, including MIT
+ and Iowa State University.
+ .
+ This package contains Hesiod's include files and static library.
Source: hesiod
Section: libs
Priority: extra
Maintainer: Karl Ramm <kcr@debian.org>
Standards-Version: 3.7.2
Build-Depends: debhelper (>= 4.1.13)
Package: hesiod
Architecture: any
Section: utils
Depends: ${shlibs:Depends}
Description: Project Athena's service name resolution protocol - utilities
Hesiod is a name service library that can provide general name service
for a variety of applications. It is derived from BIND, the Berkeley
Internet Name Daemon, and leverages the existing DNS infrastructure of a
network. It is used on a number of university networks, including MIT
and Iowa State University.
.
This package is only useful on networks that already use
Hesiod.
Package: libhesiod0
Architecture: any
Section: libs
Depends: ${shlibs:Depends}, ${misc:Depends}
Description: Project Athena's service name resolution protocol - libraries
Hesiod is a name service library that can provide general name service
for a variety of applications. It is derived from BIND, the Berkeley
Internet Name Daemon, and leverages the existing DNS infrastructure of a
network. It is used on a number of university networks, including MIT
and Iowa State University.
.
This package contains Hesiod's shared library.
Package: libhesiod-dev
Architecture: any
Section: devel
Depends: libhesiod0
Description: Project Athena's service name resolution protocol - development files
Hesiod is a name service library that can provide general name service
for a variety of applications. It is derived from BIND, the Berkeley
Internet Name Daemon, and leverages the existing DNS infrastructure of a
network. It is used on a number of university networks, including MIT
and Iowa State University.
.
This package contains Hesiod's include files and static library.
Attachment:
signature.asc
Description: Digital signature