[Pkg-silc-devel] [RFR] templates://silc-server/{templates}

Sat Oct 6 06:47:52 UTC 2007

Please find, for review, the debconf templates and packages descriptions for the silc-server source package.

This review will last from Saturday, October 06, 2007 to Tuesday, October 16, 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:

--- ../silc-server.old/debian/templates	2007-10-05 20:26:01.326190034 +0200
+++ debian/templates	2007-10-06 08:42:54.845774924 +0200
@@ -1,17 +1,17 @@
 Template: silcd/server-name
 Type: string
-_Description: silcd server name:
+_Description: SILC server name:
  Please enter the name of the SILC server (e.g. "Our SILC server").

I propose dropping the daemon name and use "SILC server" instead. That
allows using a leading capital and therefore make the synopsis look
less weird. Ditto for all other templates.


 Template: silcd/admin-nick
 Type: string
-_Description: silcd administrator nickname:
+_Description: SILC server administrator nickname:
  Please enter the nickname of the administrator of the SILC server.
  .
- The administrator will need to use this nickname in order to authenticate.
+ The administrator will use it for identification on the server.

I was worried about the repetition of "nickname". Could also be "The
administrator will use it to authenticate".

 
 Template: silcd/admin-passphrase
 Type: password
-_Description: silcd administrator passphrase:
+_Description: SILC administrator passphrase:
  Please enter the passphrase for the SILC server administrator.
  .
  The administrator will need to use this passphrase in order to authenticate.
  .
- Please note that it will be stored in an unencrypted form in a configuration
+ Please note that it will be stored in clear text in a configuration
  file.

shorter and clearer ?


--- ../silc-server.old/debian/control	2007-10-05 20:26:01.326190034 +0200
+++ debian/control	2007-10-05 20:39:02.870727719 +0200
@@ -7,6 +7,7 @@
 Standards-Version: 3.7.2
 XS-Vcs-Svn: svn://svn.debian.org/pkg-silc/silc-server/trunk
 XS-Vcs-Browser: http://svn.debian.org/wsvn/pkg-silc/silc-server/trunk
+Homepage: http://silcnet.org/software/users/server/

From what I read recently in debian/control, this can be adopted in
all packages now.

 
 Package: silcd
 Architecture: any
@@ -14,12 +15,10 @@
 Provides: silc-server
 Description: server for the SILC protocol
  SILC (Secure Internet Live Conferencing) is a network protocol designed
- to provide end-to-end security for conferencing services. SILC has a
+ to provide end-to-end security for conferencing services. SILC provides a

Better? But introduces a repetition.

  command set and a user interface similar to IRC, but the network
  protocol is completely different as it supports public key strong
  cryptography and a different network model.
  .
  This package provides a system daemon that can act as a SILC router or
  server.
- .
-  Homepage: http://silcnet.org/software/users/server/

Moved to "Homepage:" field.

-- 



-------------- next part --------------
Template: silcd/server-name
Type: string
_Description: SILC server name:
 Please enter the name of the SILC server (e.g. "Our SILC server").

Template: silcd/host-name
Type: string
_Description: SILC server hostname:
 Please enter the hostname (or the IP address) of the SILC server
 (e.g. silc.example.org).

Template: silcd/real-name
Type: string
_Description: SILC server administrator real name:
 Please enter the real name of the operator running the SILC server
 (e.g. "J. Random Operator").
 .
 This field may be left empty.

Template: silcd/email
Type: string
_Description: SILC server administrator email address:
 Please enter the email address of the operator running the SILC server
 (e.g. silc at example.org).
 .
 This field may be left empty.

Template: silcd/organization
Type: string
_Description: SILC server organization name:
 Please enter the name of the organization running the SILC server
 (e.g. "Our Organization").
 .
 This field may be left empty.

Template: silcd/country
Type: string
_Description: SILC server location:
 Please enter the name of the country where the SILC server is located.
 .
 This field may be left empty.

Template: silcd/admin-nick
Type: string
_Description: SILC server administrator nickname:
 Please enter the nickname of the administrator of the SILC server.
 .
 The administrator will use it for identification on the server.

Template: silcd/admin-passphrase
Type: password
_Description: SILC administrator passphrase:
 Please enter the passphrase for the SILC server administrator.
 .
 The administrator will need to use this passphrase in order to authenticate.
 .
 Please note that it will be stored in clear text in a configuration
 file.
-------------- next part --------------
--- ../silc-server.old/debian/templates	2007-10-05 20:26:01.326190034 +0200
+++ debian/templates	2007-10-06 08:42:54.845774924 +0200
@@ -1,17 +1,17 @@
 Template: silcd/server-name
 Type: string
-_Description: silcd server name:
+_Description: SILC server name:
  Please enter the name of the SILC server (e.g. "Our SILC server").
 
 Template: silcd/host-name
 Type: string
-_Description: silcd hostname:
+_Description: SILC server hostname:
  Please enter the hostname (or the IP address) of the SILC server
  (e.g. silc.example.org).
 
 Template: silcd/real-name
 Type: string
-_Description: silcd administrator real name:
+_Description: SILC server administrator real name:
  Please enter the real name of the operator running the SILC server
  (e.g. "J. Random Operator").
  .
@@ -19,7 +19,7 @@
 
 Template: silcd/email
 Type: string
-_Description: silcd administrator email address:
+_Description: SILC server administrator email address:
  Please enter the email address of the operator running the SILC server
  (e.g. silc at example.org).
  .
@@ -27,32 +27,32 @@
 
 Template: silcd/organization
 Type: string
-_Description: silcd organization:
- Please enter the organization running the SILC server
+_Description: SILC server organization name:
+ Please enter the name of the organization running the SILC server
  (e.g. "Our Organization").
  .
  This field may be left empty.
 
 Template: silcd/country
 Type: string
-_Description: silcd location:
- Please enter the country where the SILC server is located.
+_Description: SILC server location:
+ Please enter the name of the country where the SILC server is located.
  .
  This field may be left empty.
 
 Template: silcd/admin-nick
 Type: string
-_Description: silcd administrator nickname:
+_Description: SILC server administrator nickname:
  Please enter the nickname of the administrator of the SILC server.
  .
- The administrator will need to use this nickname in order to authenticate.
+ The administrator will use it for identification on the server.
 
 Template: silcd/admin-passphrase
 Type: password
-_Description: silcd administrator passphrase:
+_Description: SILC administrator passphrase:
  Please enter the passphrase for the SILC server administrator.
  .
  The administrator will need to use this passphrase in order to authenticate.
  .
- Please note that it will be stored in an unencrypted form in a configuration
+ Please note that it will be stored in clear text in a configuration
  file.
--- ../silc-server.old/debian/control	2007-10-05 20:26:01.326190034 +0200
+++ debian/control	2007-10-05 20:39:02.870727719 +0200
@@ -7,6 +7,7 @@
 Standards-Version: 3.7.2
 XS-Vcs-Svn: svn://svn.debian.org/pkg-silc/silc-server/trunk
 XS-Vcs-Browser: http://svn.debian.org/wsvn/pkg-silc/silc-server/trunk
+Homepage: http://silcnet.org/software/users/server/
 
 Package: silcd
 Architecture: any
@@ -14,12 +15,10 @@
 Provides: silc-server
 Description: server for the SILC protocol
  SILC (Secure Internet Live Conferencing) is a network protocol designed
- to provide end-to-end security for conferencing services. SILC has a
+ to provide end-to-end security for conferencing services. SILC provides a
  command set and a user interface similar to IRC, but the network
  protocol is completely different as it supports public key strong
  cryptography and a different network model.
  .
  This package provides a system daemon that can act as a SILC router or
  server.
- .
-  Homepage: http://silcnet.org/software/users/server/
-------------- next part --------------
Source: silc-server
Section: net
Priority: extra
Maintainer: Debian SILC Team <pkg-silc-devel at lists.alioth.debian.org>
Uploaders: Jérémy Bobbio <lunar at debian.org>
Build-Depends: debhelper (>= 5), autotools-dev, libsilc-1.1-2-dev, po-debconf
Standards-Version: 3.7.2
XS-Vcs-Svn: svn://svn.debian.org/pkg-silc/silc-server/trunk
XS-Vcs-Browser: http://svn.debian.org/wsvn/pkg-silc/silc-server/trunk
Homepage: http://silcnet.org/software/users/server/

Package: silcd
Architecture: any
Depends: libsilc-1.1-2 (>= 1.1.3-1), ${shlibs:Depends}, ${misc:Depends}, ucf
Provides: silc-server
Description: server for the SILC protocol
 SILC (Secure Internet Live Conferencing) is a network protocol designed
 to provide end-to-end security for conferencing services. SILC provides a
 command set and a user interface similar to IRC, but the network
 protocol is completely different as it supports public key strong
 cryptography and a different network model.
 .
 This package provides a system daemon that can act as a SILC router or
 server.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: Digital signature
Url : http://lists.alioth.debian.org/pipermail/pkg-silc-devel/attachments/20071006/133331b0/attachment.pgp 
