Please find, for review, the debconf templates and packages descriptions for the openslp source package.
This review will last from Sunday, September 09, 2007 to Wednesday, September 19, 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>=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:
--- ../openslp.old/debian/libslp1.templates 2007-09-05 06:08:43.868097797 +0200
+++ debian/libslp1.templates 2007-09-09 20:03:28.830445640 +0200
@@ -1,21 +1,20 @@
Template: libslp1/multicast
Type: error
-_Description: To reduce network traffic use a IP multicast enabled kernel
- The kernel version that you are currently running does not appear to
- support IP multicast. OpenSLP will continue to work even without multicast
- support in the kernel by using broadcasts. However, broadcasts are less
- efficient on the network, so please consider upgrading to a multicast
- enabled kernel.
+_Description: IP multicast enabled kernel needed to reduce traffic
Avoid complete sentences in note/error short descriptions
+ The current kernel does not support IP multicast. OpenSLP will
+ continue to work even without multicast support in the kernel, by
+ using broadcasts. However, broadcasts are less efficient on the
+ network, so please consider upgrading to a multicast-enabled kernel.
More neutral wording and be precise about the facts: no need for "does
not appear to"..:-)
Template: libslp1/multicast-route
Type: error
-_Description: Please configure a multicast route in /etc/network/interfaces
- You don't seem to have a multicast route configured. OpenSLP can take
- advantage of multicast packets and reduce traffic on your network. You can
+#flag:translate!:3
Avoid translating the commands
+_Description: Multicast route needed in /etc/network/interfaces
Title instead of sentence
+ There seem to be no multicast route configured. OpenSLP can take
+ advantage of multicast packets and reduce traffic on the network. You can
setup a multicast route automatically on system startup by adding the
- following commands to the "interface" line(s) in your
+ following commands to the "interface" line(s) in the
/etc/network/interfaces file.
Unpersonnalize things
.
- " up route add -net 224.0.0.0 netmask 240.0.0.0 dev eth0"
- .
- " down route del -net 224.0.0.0 netmask 240.0.0.0 dev eth0"
+ up route add -net 224.0.0.0 netmask 240.0.0.0 dev eth0
+ down route del -net 224.0.0.0 netmask 240.0.0.0 dev eth0
Put the commands together for readability
--- ../openslp.old/debian/control 2007-09-05 06:08:43.868097797 +0200
+++ debian/control 2007-09-09 13:50:31.501748884 +0200
@@ -12,26 +12,28 @@
Architecture: any
Depends: ${shlibs:Depends}
Suggests: openslp-doc (= ${Source-Version})
-Description: OpenSLP Server (slpd)
- Service Location Protocol is an IETF standard protocol that is used to
- discover/advertise services on the network. You can use SLP for anything
- from locating a suitable printer on your floor to discovering what LDAP
- directories are available in your organization. This package provides slpd,
- the OpenSLP daemon, which provides an SLPv2 (RFC 2608) compliant Service
- Agent and Directory Agent.
+Description: OpenSLP (Service Location Protocol) - server
Use a "family description - package description" style all along the
package descriptions.
+ Service Location Protocol is an IETF standard protocol that is used
+ to discover/advertise services on the network. It can be used for
+ anything from locating a suitable printer in the neighbourhood to
+ discovering what LDAP directories are available in the organization.
This will be repeated for all packages...and separated from the part
that is unique for each package. This helps translators and avids
redundant work.
+ .
+ This package provides slpd, the OpenSLP daemon, which provides an
+ SLPv2 (RFC 2608) compliant Service Agent and Directory Agent.
All similar changes repeated over the binary packages....
Template: libslp1/multicast Type: error _Description: IP multicast enabled kernel needed to reduce traffic The current kernel does not support IP multicast. OpenSLP will continue to work even without multicast support in the kernel, by using broadcasts. However, broadcasts are less efficient on the network, so please consider upgrading to a multicast-enabled kernel. Template: libslp1/multicast-route Type: error #flag:translate!:3 _Description: Multicast route needed in /etc/network/interfaces There seem to be no multicast route configured. OpenSLP can take advantage of multicast packets and reduce traffic on the network. You can setup a multicast route automatically on system startup by adding the following commands to the "interface" line(s) in the /etc/network/interfaces file. . up route add -net 224.0.0.0 netmask 240.0.0.0 dev eth0 down route del -net 224.0.0.0 netmask 240.0.0.0 dev eth0
--- ../openslp.old/debian/libslp1.templates 2007-09-05 06:08:43.868097797 +0200
+++ debian/libslp1.templates 2007-09-09 20:03:28.830445640 +0200
@@ -1,21 +1,20 @@
Template: libslp1/multicast
Type: error
-_Description: To reduce network traffic use a IP multicast enabled kernel
- The kernel version that you are currently running does not appear to
- support IP multicast. OpenSLP will continue to work even without multicast
- support in the kernel by using broadcasts. However, broadcasts are less
- efficient on the network, so please consider upgrading to a multicast
- enabled kernel.
+_Description: IP multicast enabled kernel needed to reduce traffic
+ The current kernel does not support IP multicast. OpenSLP will
+ continue to work even without multicast support in the kernel, by
+ using broadcasts. However, broadcasts are less efficient on the
+ network, so please consider upgrading to a multicast-enabled kernel.
Template: libslp1/multicast-route
Type: error
-_Description: Please configure a multicast route in /etc/network/interfaces
- You don't seem to have a multicast route configured. OpenSLP can take
- advantage of multicast packets and reduce traffic on your network. You can
+#flag:translate!:3
+_Description: Multicast route needed in /etc/network/interfaces
+ There seem to be no multicast route configured. OpenSLP can take
+ advantage of multicast packets and reduce traffic on the network. You can
setup a multicast route automatically on system startup by adding the
- following commands to the "interface" line(s) in your
+ following commands to the "interface" line(s) in the
/etc/network/interfaces file.
.
- " up route add -net 224.0.0.0 netmask 240.0.0.0 dev eth0"
- .
- " down route del -net 224.0.0.0 netmask 240.0.0.0 dev eth0"
+ up route add -net 224.0.0.0 netmask 240.0.0.0 dev eth0
+ down route del -net 224.0.0.0 netmask 240.0.0.0 dev eth0
--- ../openslp.old/debian/control 2007-09-05 06:08:43.868097797 +0200
+++ debian/control 2007-09-09 13:50:31.501748884 +0200
@@ -12,26 +12,28 @@
Architecture: any
Depends: ${shlibs:Depends}
Suggests: openslp-doc (= ${Source-Version})
-Description: OpenSLP Server (slpd)
- Service Location Protocol is an IETF standard protocol that is used to
- discover/advertise services on the network. You can use SLP for anything
- from locating a suitable printer on your floor to discovering what LDAP
- directories are available in your organization. This package provides slpd,
- the OpenSLP daemon, which provides an SLPv2 (RFC 2608) compliant Service
- Agent and Directory Agent.
+Description: OpenSLP (Service Location Protocol) - server
+ Service Location Protocol is an IETF standard protocol that is used
+ to discover/advertise services on the network. It can be used for
+ anything from locating a suitable printer in the neighbourhood to
+ discovering what LDAP directories are available in the organization.
+ .
+ This package provides slpd, the OpenSLP daemon, which provides an
+ SLPv2 (RFC 2608) compliant Service Agent and Directory Agent.
Package: openslp-doc
Section: doc
Priority: extra
Architecture: all
-Description: OpenSLP documentation
- Service Location Protocol is an IETF standard protocol that is used to
- discover/advertise services on the network. You can use SLP for anything
- from locating a suitable printer on your floor to discovering what LDAP
- directories are available in your organization. This package provides
- comprehensive documentation on SLP and the OpenSLP implementation; it
- contains an Introduction to SLP, a User's Guide, a Programmer's Guide and
- related RFCs.
+Description: OpenSLP (Service Location Protocol) - documentation
+ Service Location Protocol is an IETF standard protocol that is used
+ to discover/advertise services on the network. It can be used for
+ anything from locating a suitable printer in the neighbourhood to
+ discovering what LDAP directories are available in the organization.
+ .
+ This package provides comprehensive documentation on SLP and the
+ OpenSLP implementation; it contains an Introduction to SLP, a User's
+ Guide, a Programmer's Guide and related RFCs.
Package: libslp1
Section: libs
@@ -39,15 +41,17 @@
Architecture: any
Depends: ${shlibs:Depends}, debconf | debconf-2.0, net-tools
Suggests: slpd (= ${Source-Version}), openslp-doc (= ${Source-Version})
-Description: OpenSLP libraries
- Service Location Protocol is an IETF standard protocol that is used to
- discover/advertise services on the network. You can use SLP for anything
- from locating a suitable printer on your floor to discovering what LDAP
- directories are available in your organization. This package provides
- the OpenSLP run-time library package that is linked to SLP aware
- applications. This library implements RFC 2614 - An API for Service
- Location. Unless there is a SLP DA in the network, you must install the
- slpd package to be able to advertise the services.
+Description: OpenSLP (Service Location Protocol) - libraries
+ Service Location Protocol is an IETF standard protocol that is used
+ to discover/advertise services on the network. It can be used for
+ anything from locating a suitable printer in the neighbourhood to
+ discovering what LDAP directories are available in the organization.
+ .
+ This package provides the OpenSLP run-time library package that is
+ linked to SLP aware applications. This library implements RFC 2614 -
+ An API for Service Location. Unless there is a SLP DA in the network,
+ you must install the slpd package to be able to advertise the
+ services.
Package: slptool
Section: utils
@@ -55,12 +59,13 @@
Architecture: any
Depends: libslp1 (= ${Source-Version})
Suggests: openslp-doc (= ${Source-Version})
-Description: SLP command line tool
- Service Location Protocol is an IETF standard protocol that is used to
- discover/advertise services on the network. You can use SLP for anything
- from locating a suitable printer on your floor to discovering what LDAP
- directories are available in your organization. This package contains
- the a utility which you can use to exercise/test SLP.
+Description: OpenSLP (Service Location Protocol) - command line tool
+ Service Location Protocol is an IETF standard protocol that is used
+ to discover/advertise services on the network. It can be used for
+ anything from locating a suitable printer in the neighbourhood to
+ discovering what LDAP directories are available in the organization.
+ .
+ This package provides a utility which can be used to practice with SLP.
Package: libslp-dev
Section: libdevel
@@ -69,12 +74,15 @@
Depends: libslp1 (= ${Source-Version}), libc6-dev
Suggests: openslp-doc (= ${Source-Version})
Conflicts: libxdelta3-dev
-Description: OpenSLP development libraries
- Service Location Protocol is an IETF standard protocol that is used to
- discover/advertise services on the network. You can use SLP for anything
- from locating a suitable printer on your floor to discovering what LDAP
- directories are available in your organization. This package allows
- development of SLP applications using the OpenSLP libraries. It includes
- headers, libraries and links to allow static and dynamic linking. It also
- includes slptool, a utility to test service advertisement/lookup. The
- library implements RFC 2614 - An API for Service Location.
+Description: OpenSLP (Service Location Protocol) - development libraries
+ Service Location Protocol is an IETF standard protocol that is used
+ to discover/advertise services on the network. It can be used for
+ anything from locating a suitable printer in the neighbourhood to
+ discovering what LDAP directories are available in the organization.
+ .
+ This package allows the development of SLP applications using the
+ OpenSLP libraries. It includes headers, libraries and links to allow
+ static and dynamic linking. It also includes slptool, a utility to
+ test service advertisement/lookup. The library implements RFC 2614 -
+ An API for Service Location.
+
Source: openslp
Section: net
Priority: extra
Maintainer: Ganesan Rajagopal <rganesan@debian.org>
Build-Depends: debhelper (>= 4.1.26), debconf | debconf-2.0, autotools-dev
Build-Conflicts: libssl-dev
Standards-Version: 3.6.2
Package: slpd
Section: net
Priority: extra
Architecture: any
Depends: ${shlibs:Depends}
Suggests: openslp-doc (= ${Source-Version})
Description: OpenSLP (Service Location Protocol) - server
Service Location Protocol is an IETF standard protocol that is used
to discover/advertise services on the network. It can be used for
anything from locating a suitable printer in the neighbourhood to
discovering what LDAP directories are available in the organization.
.
This package provides slpd, the OpenSLP daemon, which provides an
SLPv2 (RFC 2608) compliant Service Agent and Directory Agent.
Package: openslp-doc
Section: doc
Priority: extra
Architecture: all
Description: OpenSLP (Service Location Protocol) - documentation
Service Location Protocol is an IETF standard protocol that is used
to discover/advertise services on the network. It can be used for
anything from locating a suitable printer in the neighbourhood to
discovering what LDAP directories are available in the organization.
.
This package provides comprehensive documentation on SLP and the
OpenSLP implementation; it contains an Introduction to SLP, a User's
Guide, a Programmer's Guide and related RFCs.
Package: libslp1
Section: libs
Priority: optional
Architecture: any
Depends: ${shlibs:Depends}, debconf | debconf-2.0, net-tools
Suggests: slpd (= ${Source-Version}), openslp-doc (= ${Source-Version})
Description: OpenSLP (Service Location Protocol) - libraries
Service Location Protocol is an IETF standard protocol that is used
to discover/advertise services on the network. It can be used for
anything from locating a suitable printer in the neighbourhood to
discovering what LDAP directories are available in the organization.
.
This package provides the OpenSLP run-time library package that is
linked to SLP aware applications. This library implements RFC 2614 -
An API for Service Location. Unless there is a SLP DA in the network,
you must install the slpd package to be able to advertise the
services.
Package: slptool
Section: utils
Priority: extra
Architecture: any
Depends: libslp1 (= ${Source-Version})
Suggests: openslp-doc (= ${Source-Version})
Description: OpenSLP (Service Location Protocol) - command line tool
Service Location Protocol is an IETF standard protocol that is used
to discover/advertise services on the network. It can be used for
anything from locating a suitable printer in the neighbourhood to
discovering what LDAP directories are available in the organization.
.
This package provides a utility which can be used to practice with SLP.
Package: libslp-dev
Section: libdevel
Priority: extra
Architecture: any
Depends: libslp1 (= ${Source-Version}), libc6-dev
Suggests: openslp-doc (= ${Source-Version})
Conflicts: libxdelta3-dev
Description: OpenSLP (Service Location Protocol) - development libraries
Service Location Protocol is an IETF standard protocol that is used
to discover/advertise services on the network. It can be used for
anything from locating a suitable printer in the neighbourhood to
discovering what LDAP directories are available in the organization.
.
This package allows the development of SLP applications using the
OpenSLP libraries. It includes headers, libraries and links to allow
static and dynamic linking. It also includes slptool, a utility to
test service advertisement/lookup. The library implements RFC 2614 -
An API for Service Location.
Attachment:
signature.asc
Description: Digital signature