Please find, for review, the debconf templates and packages descriptions for the nis source package.
This review will last from Tuesday, May 12, 2009 to Friday, May 22, 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:
--- nis.old/debian/templates 2009-05-08 08:48:09.243683102 +0200
+++ nis/debian/templates 2009-05-12 08:09:16.875677559 +0200
@@ -1,8 +1,10 @@
Template: nis/domain
Type: string
-_Default:
This is unneeded if the default is empty. Making it translatable is
even more unneeded.
-_Description: NIS domain
- You now need to choose a NIS domainname for your system. If you want this
- machine to just be a client, enter the NIS domainname of your network.
- Otherwise choose an appropriate NIS domainname.
-
+_Description: NIS domain:
Use colon on string templates. Common practice.
+ Please choose the NIS domain name for this system. If you want this
+ machine to just be a client, you should enter the name of the
+ existing NIS domain.
+ .
+ Alternatively, if this machine is planned to be a NIS server, you can
+ either enter a new NIS domain name (which will create that domain) or
+ the name of an existing NIS domain.
Reformulating was tricky for me.
First, I changed to our common wording ("Please choose....").
Also, I dropped personnalization ("your network"....this is not
necessarily mine).
Then, I tried to clarify things between the client case and the server
case. Not sure that my proposal is perfect, though.
--- nis.old/debian/control 2009-05-08 08:48:09.239833538 +0200
+++ nis/debian/control 2009-05-12 08:10:24.163676270 +0200
@@ -12,8 +12,8 @@
Pre-Depends: debconf (>= 0.5.00) | debconf-2.0
Depends: ${shlibs:Depends}, netbase, make, portmap, lsb-base (>= 3.0-6)
Conflicts: netstd (<=1.26)
-Description: Clients and daemons for the Network Information Services (NIS)
- The nis package allows you to use the NIS services from a NIS server or
- to set up your own NIS server. NIS is mostly used to let several machines
- in a network share the same account information (eg the password file).
+Description: clients and daemons for Network Information Services (NIS)
Drop leading capital per DevRef recommendations.
Drop "the": there is not only one "Network Information Services"
+ This package allows using NIS services from a NIS server or
+ to set up a NIS server. NIS is mostly used to let several machines
+ in a network share the same account information, such as the password file.
NIS was formerly called Yellow Pages (YP).
Drop "you" and jump into my usual "allows to" nightmare..:-)
Also drop "your" NIS server...
--
Template: nis/domain Type: string _Description: NIS domain: Please choose the NIS domain name for this system. If you want this machine to just be a client, you should enter the name of the existing NIS domain. . Alternatively, if this machine is planned to be a NIS server, you can either enter a new NIS domain name (which will create that domain) or the name of an existing NIS domain.
--- nis.old/debian/templates 2009-05-08 08:48:09.243683102 +0200
+++ nis/debian/templates 2009-05-12 08:09:16.875677559 +0200
@@ -1,8 +1,10 @@
Template: nis/domain
Type: string
-_Default:
-_Description: NIS domain
- You now need to choose a NIS domainname for your system. If you want this
- machine to just be a client, enter the NIS domainname of your network.
- Otherwise choose an appropriate NIS domainname.
-
+_Description: NIS domain:
+ Please choose the NIS domain name for this system. If you want this
+ machine to just be a client, you should enter the name of the
+ existing NIS domain.
+ .
+ Alternatively, if this machine is planned to be a NIS server, you can
+ either enter a new NIS domain name (which will create that domain) or
+ the name of an existing NIS domain.
--- nis.old/debian/control 2009-05-08 08:48:09.239833538 +0200
+++ nis/debian/control 2009-05-12 08:10:24.163676270 +0200
@@ -12,8 +12,8 @@
Pre-Depends: debconf (>= 0.5.00) | debconf-2.0
Depends: ${shlibs:Depends}, netbase, make, portmap, lsb-base (>= 3.0-6)
Conflicts: netstd (<=1.26)
-Description: Clients and daemons for the Network Information Services (NIS)
- The nis package allows you to use the NIS services from a NIS server or
- to set up your own NIS server. NIS is mostly used to let several machines
- in a network share the same account information (eg the password file).
+Description: clients and daemons for Network Information Services (NIS)
+ This package allows using NIS services from a NIS server or
+ to set up a NIS server. NIS is mostly used to let several machines
+ in a network share the same account information, such as the password file.
NIS was formerly called Yellow Pages (YP).
Source: nis
Section: net
Priority: extra
Maintainer: Mark Brown <broonie@debian.org>
Uploaders: Miquel van Smoorenburg <miquels@cistron.nl>
Standards-Version: 3.8.1
Build-Depends: libgdbm-dev, gcc (>= 2.95), gettext, po-debconf, libslp-dev, libdbus-glib-1-dev, network-manager-dev, file
Vcs-Bzr: http://bzr.debian.org/bzr/pkg-nis/nis/debian/
Package: nis
Architecture: any
Pre-Depends: debconf (>= 0.5.00) | debconf-2.0
Depends: ${shlibs:Depends}, netbase, make, portmap, lsb-base (>= 3.0-6)
Conflicts: netstd (<=1.26)
Description: clients and daemons for Network Information Services (NIS)
This package allows using NIS services from a NIS server or
to set up a NIS server. NIS is mostly used to let several machines
in a network share the same account information, such as the password file.
NIS was formerly called Yellow Pages (YP).
Attachment:
signature.asc
Description: Digital signature