[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

[RFR] templates://zephyr/{zephyr-clients.templates,zephyr-server.templates }



Please find, for review, the debconf templates and packages descriptions for the zephyr source package.

This review will last from Tuesday, November 13, 2007 to Friday, November 23, 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:
--- ../zephyr.old/debian/zephyr-clients.templates	2007-10-25 20:43:25.179785522 +0000
+++ debian/zephyr-clients.templates	2007-11-07 06:02:15.246875541 +0000
@@ -1,10 +1,12 @@
 Template: zephyr-clients/servers
 Type: string
 _Description: Zephyr servers:
- Please type the full names of your zephyr servers, separated by spaces.
- (note that this can be a subset of what you're telling the servers)
- If you are using hesiod to advertise your zephyr servers, leave this
- blank.
+ Please specify the space-separated list of full names for the Zephyr servers.
+ .
+ The list configured on clients can be only a subset of the list configured
+ on servers.

s/type/specify...is a common change we propose

Capitalize "Zephyr"

"space-separated" is also a change we commonly propose in such situations.

Split the paragraph in two parts to improve readability.

+ .
+ This can be left empty if Hesiod is used to advertize Zephyr servers.

And this also goes into its own paragraph, with capitalization of Hesiod.
 
 Template: zephyr-clients/read_conf
 Type: boolean
--- ../zephyr.old/debian/zephyr-server.templates	2007-10-25 20:43:25.179785522 +0000
+++ debian/zephyr-server.templates	2007-11-07 06:02:19.246669065 +0000
@@ -1,8 +1,10 @@
 Template: zephyr-server/servers
 Type: string
 _Description: Zephyr servers:
- Please type the full names of your zephyr servers, separated by spaces.
- (Note that this can be a superset of that you're telling the clients.)
+ Please specify the space-separated list of full names for the Zephyr servers.
+ .
+ The list configured on clients can be only a subset of the list configured
+ on servers.

Same changes.
 
 Template: zephyr-server/read_conf
 Type: boolean
--- ../zephyr.old/debian/control	2007-10-25 20:43:25.179785522 +0000
+++ debian/control	2007-11-07 06:15:30.212755386 +0000
@@ -11,11 +11,13 @@
 Architecture: any
 Depends: ${shlibs:Depends}
 Conflicts: libzephyr3-krb
-Description: The original "Instant Message" system libraries without Kerberos
- This is the Project Athena Zephyr notification system 2000/04/21 snapshot.
+Description: Project Athena's instant messaging service - non-Kerberos libraries

Use the "generic - specific" style for the synopsis.

  Zephyr allows users to send messages to other users or to groups of
- users.  Users can view incoming Zephyr messages as windowgrams
+ users. Users can view incoming Zephyr messages as windowgrams

Remove double spaces

  (transient X windows) or as text on a terminal.
+ .
+ This package provides the libraries without Kerberos support for message
+ authentication.

Add the specific part as a separate paragraph.
 
 Package: libzephyr3-krb
 Section: libs
@@ -23,75 +25,76 @@
 Depends: ${shlibs:Depends}, krb4-config
 Conflicts: libzephyr3
 Provides: libzephyr3
-Description: The original "Instant Message" system libraries with Kerberos 
- This version of the library uses Kerberos for message authentication.
- .
- This is the Project Athena Zephyr notification system 2000/04/21 snapshot.
+Description: Project Athena's instant messaging service - libraries with Kerberos support
  Zephyr allows users to send messages to other users or to groups of
- users.  Users can view incoming Zephyr messages as windowgrams
+ users. Users can view incoming Zephyr messages as windowgrams
  (transient X windows) or as text on a terminal.
+ .
+ This package provides libraries that use Kerberos for message
+ authentication.

Same changes

 
 Package: zephyr-clients
 Section: net
 Replaces: zephyr-client
 Architecture: any
 Depends: ${shlibs:Depends}, debianutils (>= 1.6), debconf | debconf-2.0
-Description: The original "Instant Message" system client
- This package only contains the clients; you'll need a server to talk to.
- .
- This is the Project Athena Zephyr notification system 2000/04/21 snapshot.
+Description: Project Athena's instant messaging service - client programs
  Zephyr allows users to send messages to other users or to groups of
- users.  Users can view incoming Zephyr messages as windowgrams
+ users. Users can view incoming Zephyr messages as windowgrams
  (transient X windows) or as text on a terminal.
+ .
+ This package provides client programs for the messaging service. They
+ require a Zephyr server for being fully operationnal.

Same changes.

Note that this drops the "2000/04/21 snapshot" as keeping a version
number in a package description is probably not a very good idea.
 
 Package: zephyr-server
 Section: net
 Architecture: any
 Depends: ${shlibs:Depends}, debconf | debconf-2.0
 Conflicts: zephyr-server-krb
-Description: The original "Instant Message" system-server without Kerberos
- You probably only need one server for a group of clients.
- This can be a memory-intensive server, especially for very large sites.
+Description: Project Athena's instant messaging service - server without Kerberos support
+ Zephyr allows users to send messages to other users or to groups of
+ users. Users can view incoming Zephyr messages as windowgrams
+ (transient X windows) or as text on a terminal.
+ .
+ This package provides the server for the messaging service. Only one
+ server is needed for a group of client. The program consumes much memory,
+ especially for very large sites.
  .
  The server maintains a location and subscription database for all the
  receiving clients. All zephyrgrams are sent to the server to be routed
  to the intended recipient.
- .
- This is the Project Athena Zephyr notification system 2000/04/21 snapshot.
- Zephyr allows users to send messages to other users or to groups of
- users.  Users can view incoming Zephyr messages as windowgrams
- (transient X windows) or as text on a terminal.

Same changes

 
 Package: zephyr-server-krb
 Section: net
 Architecture: any
 Depends: ${shlibs:Depends}, debconf | debconf-2.0, libzephyr3-krb
 Conflicts: zephyr-server
-Description: The original "Instant Message" system-server with Kerberos
- You probably only need one server for a group of clients.
- This can be a memory-intensive server, especially for very large sites.
+Description: Project Athena's instant messaging service - server with Kerberos support
+ Zephyr allows users to send messages to other users or to groups of
+ users. Users can view incoming Zephyr messages as windowgrams
+ (transient X windows) or as text on a terminal.
+ .
+ This package provides the server for the messaging service. Only one
+ server is needed for a group of client. The program consumes much memory,
+ especially for very large sites.
  .
  The server maintains a location and subscription database for all the
  receiving clients. All zephyrgrams are sent to the server to be routed
  to the intended recipient.
  .
  This version of the server uses Kerberos for message authentication.
- .
- This is the Project Athena Zephyr notification system 2000/04/21 snapshot.
- Zephyr allows users to send messages to other users or to groups of
- users.  Users can view incoming Zephyr messages as windowgrams
- (transient X windows) or as text on a terminal.

And again...
 
 Package: libzephyr-dev
 Section: libdevel
 Architecture: any
 Depends: libzephyr3 (= ${binary:Version}) | libzephyr3-krb (= ${binary:Version}), libc6-dev
-Description: The original "Instant Message" system development libraries
- This package is needed to compile certain other zephyr clients. There are
- various other clients available, including a totally gratuitous Motif client,
- a Tcl client, several Emacs clients, and a number of X clients.
- .
- This is the Project Athena Zephyr notification system 2000/04/21 snapshot.
+Description: Project Athena's instant messaging service - development files
  Zephyr allows users to send messages to other users or to groups of
- users.  Users can view incoming Zephyr messages as windowgrams
+ users. Users can view incoming Zephyr messages as windowgrams
  (transient X windows) or as text on a terminal.
+ .
+ This package provides development libraries and files. It is needed
+ to compile alternative Zephyr clients, such as a free (as in free
+ beer) Motif client, a Tcl client, several Emacs clients, and a number
+ of X clients.
+

Same changes PLUS rewording the last paragraph (the "gratuitous" thing
doesn't sound well for me...but others might disagree and my proposal
may be not perfect as well.


-- 


Template: zephyr-clients/servers
Type: string
_Description: Zephyr servers:
 Please specify the space-separated list of full names for the Zephyr servers.
 .
 The list configured on clients can be only a subset of the list configured
 on servers.
 .
 This can be left empty if Hesiod is used to advertize Zephyr servers.

Template: zephyr-clients/read_conf
Type: boolean
Default: true
Description: for internal use
 We want to try and capture user changes when they edit a config file
 manually.  To do this we look at the file in the config script. However,
 in the case of preconfigure, the config script is run twice before the
 postinst is run.  Thus we may read the wrong value before the edited value
 is written out in postinst. If this is false we skip reading config files
 until postinst runs.
Template: zephyr-server/servers
Type: string
_Description: Zephyr servers:
 Please specify the space-separated list of full names for the Zephyr servers.
 .
 The list configured on clients can be only a subset of the list configured
 on servers.

Template: zephyr-server/read_conf
Type: boolean
Default: true
Description: for internal use
 We want to try and capture user changes when they edit a config file
 manually.  To do this we look at the file in the config script. However,
 in the case of preconfigure, the config script is run twice before the
 postinst is run.  Thus we may read the wrong value before the edited value
 is written out in postinst. If this is false we skip reading config files
 until postinst runs.
--- ../zephyr.old/debian/zephyr-clients.templates	2007-10-25 20:43:25.179785522 +0000
+++ debian/zephyr-clients.templates	2007-11-07 06:02:15.246875541 +0000
@@ -1,10 +1,12 @@
 Template: zephyr-clients/servers
 Type: string
 _Description: Zephyr servers:
- Please type the full names of your zephyr servers, separated by spaces.
- (note that this can be a subset of what you're telling the servers)
- If you are using hesiod to advertise your zephyr servers, leave this
- blank.
+ Please specify the space-separated list of full names for the Zephyr servers.
+ .
+ The list configured on clients can be only a subset of the list configured
+ on servers.
+ .
+ This can be left empty if Hesiod is used to advertize Zephyr servers.
 
 Template: zephyr-clients/read_conf
 Type: boolean
--- ../zephyr.old/debian/zephyr-server.templates	2007-10-25 20:43:25.179785522 +0000
+++ debian/zephyr-server.templates	2007-11-07 06:02:19.246669065 +0000
@@ -1,8 +1,10 @@
 Template: zephyr-server/servers
 Type: string
 _Description: Zephyr servers:
- Please type the full names of your zephyr servers, separated by spaces.
- (Note that this can be a superset of that you're telling the clients.)
+ Please specify the space-separated list of full names for the Zephyr servers.
+ .
+ The list configured on clients can be only a subset of the list configured
+ on servers.
 
 Template: zephyr-server/read_conf
 Type: boolean
--- ../zephyr.old/debian/control	2007-10-25 20:43:25.179785522 +0000
+++ debian/control	2007-11-07 06:15:30.212755386 +0000
@@ -11,11 +11,13 @@
 Architecture: any
 Depends: ${shlibs:Depends}
 Conflicts: libzephyr3-krb
-Description: The original "Instant Message" system libraries without Kerberos
- This is the Project Athena Zephyr notification system 2000/04/21 snapshot.
+Description: Project Athena's instant messaging service - non-Kerberos libraries
  Zephyr allows users to send messages to other users or to groups of
- users.  Users can view incoming Zephyr messages as windowgrams
+ users. Users can view incoming Zephyr messages as windowgrams
  (transient X windows) or as text on a terminal.
+ .
+ This package provides the libraries without Kerberos support for message
+ authentication.
 
 Package: libzephyr3-krb
 Section: libs
@@ -23,75 +25,76 @@
 Depends: ${shlibs:Depends}, krb4-config
 Conflicts: libzephyr3
 Provides: libzephyr3
-Description: The original "Instant Message" system libraries with Kerberos 
- This version of the library uses Kerberos for message authentication.
- .
- This is the Project Athena Zephyr notification system 2000/04/21 snapshot.
+Description: Project Athena's instant messaging service - libraries with Kerberos support
  Zephyr allows users to send messages to other users or to groups of
- users.  Users can view incoming Zephyr messages as windowgrams
+ users. Users can view incoming Zephyr messages as windowgrams
  (transient X windows) or as text on a terminal.
+ .
+ This package provides libraries that use Kerberos for message
+ authentication.
 
 Package: zephyr-clients
 Section: net
 Replaces: zephyr-client
 Architecture: any
 Depends: ${shlibs:Depends}, debianutils (>= 1.6), debconf | debconf-2.0
-Description: The original "Instant Message" system client
- This package only contains the clients; you'll need a server to talk to.
- .
- This is the Project Athena Zephyr notification system 2000/04/21 snapshot.
+Description: Project Athena's instant messaging service - client programs
  Zephyr allows users to send messages to other users or to groups of
- users.  Users can view incoming Zephyr messages as windowgrams
+ users. Users can view incoming Zephyr messages as windowgrams
  (transient X windows) or as text on a terminal.
+ .
+ This package provides client programs for the messaging service. They
+ require a Zephyr server for being fully operationnal.
 
 Package: zephyr-server
 Section: net
 Architecture: any
 Depends: ${shlibs:Depends}, debconf | debconf-2.0
 Conflicts: zephyr-server-krb
-Description: The original "Instant Message" system-server without Kerberos
- You probably only need one server for a group of clients.
- This can be a memory-intensive server, especially for very large sites.
+Description: Project Athena's instant messaging service - server without Kerberos support
+ Zephyr allows users to send messages to other users or to groups of
+ users. Users can view incoming Zephyr messages as windowgrams
+ (transient X windows) or as text on a terminal.
+ .
+ This package provides the server for the messaging service. Only one
+ server is needed for a group of client. The program consumes much memory,
+ especially for very large sites.
  .
  The server maintains a location and subscription database for all the
  receiving clients. All zephyrgrams are sent to the server to be routed
  to the intended recipient.
- .
- This is the Project Athena Zephyr notification system 2000/04/21 snapshot.
- Zephyr allows users to send messages to other users or to groups of
- users.  Users can view incoming Zephyr messages as windowgrams
- (transient X windows) or as text on a terminal.
 
 Package: zephyr-server-krb
 Section: net
 Architecture: any
 Depends: ${shlibs:Depends}, debconf | debconf-2.0, libzephyr3-krb
 Conflicts: zephyr-server
-Description: The original "Instant Message" system-server with Kerberos
- You probably only need one server for a group of clients.
- This can be a memory-intensive server, especially for very large sites.
+Description: Project Athena's instant messaging service - server with Kerberos support
+ Zephyr allows users to send messages to other users or to groups of
+ users. Users can view incoming Zephyr messages as windowgrams
+ (transient X windows) or as text on a terminal.
+ .
+ This package provides the server for the messaging service. Only one
+ server is needed for a group of client. The program consumes much memory,
+ especially for very large sites.
  .
  The server maintains a location and subscription database for all the
  receiving clients. All zephyrgrams are sent to the server to be routed
  to the intended recipient.
  .
  This version of the server uses Kerberos for message authentication.
- .
- This is the Project Athena Zephyr notification system 2000/04/21 snapshot.
- Zephyr allows users to send messages to other users or to groups of
- users.  Users can view incoming Zephyr messages as windowgrams
- (transient X windows) or as text on a terminal.
 
 Package: libzephyr-dev
 Section: libdevel
 Architecture: any
 Depends: libzephyr3 (= ${binary:Version}) | libzephyr3-krb (= ${binary:Version}), libc6-dev
-Description: The original "Instant Message" system development libraries
- This package is needed to compile certain other zephyr clients. There are
- various other clients available, including a totally gratuitous Motif client,
- a Tcl client, several Emacs clients, and a number of X clients.
- .
- This is the Project Athena Zephyr notification system 2000/04/21 snapshot.
+Description: Project Athena's instant messaging service - development files
  Zephyr allows users to send messages to other users or to groups of
- users.  Users can view incoming Zephyr messages as windowgrams
+ users. Users can view incoming Zephyr messages as windowgrams
  (transient X windows) or as text on a terminal.
+ .
+ This package provides development libraries and files. It is needed
+ to compile alternative Zephyr clients, such as a free (as in free
+ beer) Motif client, a Tcl client, several Emacs clients, and a number
+ of X clients.
+
Source: zephyr
Section: net
Priority: optional
Maintainer: Karl Ramm <kcr@debian.org>
Uploaders: Karl Ramm <kcr@debian.org>, Sam Hartman <hartmans@debian.org>
Build-Depends: debhelper (>= 4), libares-dev, libkrb5-dev (>= 1.2.2-4), comerr-dev, ss-dev, libreadline5-dev, libx11-dev, libxt-dev, x-dev, libxaw7-dev | libxaw8-dev, libxmu-dev, libncurses5-dev, bison, libhesiod-dev
Standards-Version: 3.7.2.2

Package: libzephyr3
Section: libs
Architecture: any
Depends: ${shlibs:Depends}
Conflicts: libzephyr3-krb
Description: Project Athena's instant messaging service - non-Kerberos libraries
 Zephyr allows users to send messages to other users or to groups of
 users. Users can view incoming Zephyr messages as windowgrams
 (transient X windows) or as text on a terminal.
 .
 This package provides the libraries without Kerberos support for message
 authentication.

Package: libzephyr3-krb
Section: libs
Architecture: any
Depends: ${shlibs:Depends}, krb4-config
Conflicts: libzephyr3
Provides: libzephyr3
Description: Project Athena's instant messaging service - libraries with Kerberos support
 Zephyr allows users to send messages to other users or to groups of
 users. Users can view incoming Zephyr messages as windowgrams
 (transient X windows) or as text on a terminal.
 .
 This package provides libraries that use Kerberos for message
 authentication.

Package: zephyr-clients
Section: net
Replaces: zephyr-client
Architecture: any
Depends: ${shlibs:Depends}, debianutils (>= 1.6), debconf | debconf-2.0
Description: Project Athena's instant messaging service - client programs
 Zephyr allows users to send messages to other users or to groups of
 users. Users can view incoming Zephyr messages as windowgrams
 (transient X windows) or as text on a terminal.
 .
 This package provides client programs for the messaging service. They
 require a Zephyr server for being fully operationnal.

Package: zephyr-server
Section: net
Architecture: any
Depends: ${shlibs:Depends}, debconf | debconf-2.0
Conflicts: zephyr-server-krb
Description: Project Athena's instant messaging service - server without Kerberos support
 Zephyr allows users to send messages to other users or to groups of
 users. Users can view incoming Zephyr messages as windowgrams
 (transient X windows) or as text on a terminal.
 .
 This package provides the server for the messaging service. Only one
 server is needed for a group of client. The program consumes much memory,
 especially for very large sites.
 .
 The server maintains a location and subscription database for all the
 receiving clients. All zephyrgrams are sent to the server to be routed
 to the intended recipient.

Package: zephyr-server-krb
Section: net
Architecture: any
Depends: ${shlibs:Depends}, debconf | debconf-2.0, libzephyr3-krb
Conflicts: zephyr-server
Description: Project Athena's instant messaging service - server with Kerberos support
 Zephyr allows users to send messages to other users or to groups of
 users. Users can view incoming Zephyr messages as windowgrams
 (transient X windows) or as text on a terminal.
 .
 This package provides the server for the messaging service. Only one
 server is needed for a group of client. The program consumes much memory,
 especially for very large sites.
 .
 The server maintains a location and subscription database for all the
 receiving clients. All zephyrgrams are sent to the server to be routed
 to the intended recipient.
 .
 This version of the server uses Kerberos for message authentication.

Package: libzephyr-dev
Section: libdevel
Architecture: any
Depends: libzephyr3 (= ${binary:Version}) | libzephyr3-krb (= ${binary:Version}), libc6-dev
Description: Project Athena's instant messaging service - development files
 Zephyr allows users to send messages to other users or to groups of
 users. Users can view incoming Zephyr messages as windowgrams
 (transient X windows) or as text on a terminal.
 .
 This package provides development libraries and files. It is needed
 to compile alternative Zephyr clients, such as a free (as in free
 beer) Motif client, a Tcl client, several Emacs clients, and a number
 of X clients.

Attachment: signature.asc
Description: Digital signature


Reply to: