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

[RFR] templates://roundcube/{templates}



Please find, for review, the debconf templates of roundcube.

This review will last from Friday, May 11, 2007 to Monday, May 21, 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:

 Type: multiselect
 _Choices: apache, apache-ssl, apache-perl, apache2
 Default: apache, apache-ssl, apache-perl, apache2
-_Description: Webserver Reconfiguration:
- RoundCube supports any web server that php does, but this automatic
- configuration process only supports Apache. Please select which 
- apache version you want to configure the RoundCube frontend for.
+_Description: Web server(s) to configure automatically:
+ RoundCube supports any web server supported by PHP, however only
+ Apache can be configured automatically.
+ .
+ Please select the web server(s) that should be configured
+ automatically for RoundCube.

Usual wording of such templates. We already reviewed a few ones (/me
wishes someone creates a package with common templates for such cases)

 
 Template: roundcube/restart-webserver
 Type: boolean
 Default: true
-_Description: Would you like to restart your webserver(s) now?
- Remember that in order to apply the changes your webserver(s) has/have to
- be restarted. 
+_Description: Should the webserver(s) be restartednow?
+ In order to activate the new configuration, the reconfigured web
+ servers have to be restarted.

Ditto. We already review a few packages with such wording

 
 Template: roundcube/hosts
 Type: string
 Default:
-_Description: IMAP server on which RoundCube should connect to:
- Leave this field blank to show a textbox at login, give a list
- of space-separated hosts to display a pulldown menu or set one
- host. To use SSL connection, use ssl://hostname:993.
+_Description: IMAP server(s) used with RoundCube:
+ Please select the IMAP server that should be used with RoundCube.
+ .
+ If this is left blank, a text box will be displayed at
+ login. Entering a space-separated list of hosts will display a
+ pulldown menu. Entering a single host will enforce using this
+ host.
+ .
+ To use SSL connections, please enter host names as 'ssl://hostname:993'.

Short description: make it more simple and direct. Could be improved,
maybe.

Long description: make it clearer

 
 Template: roundcube/language
 Type: select
 Choices: ${languages}
 _Description: Default language:
- Each user can select in his preferences the language of the
- interface. However, for the login screen and for the first
- connection, this is the language selected here that will be used.
+ Please choose the default language for RoundCube.
+ .
+ This choice can be overridden by individual users in their preferences.
+ .
+ However, the default language will be used for the login screen and
+ the first connection of users.

Long description: 
- avoid being non gender neutral ("his")

Maintainer: the list of languages should be localized. Please have a
look at debconf templates for the "geneweb" package to get an example
of using iso-codes translations to display a list of supported
languages, have it localized *and* not require additional work by
translators...:-)


--- /home/bubulle/travail/debian/rewrite/INTENT/roundcube/roundcube.old/debian/control	2007-05-06 07:49:41.943884633 +0200
+++ /home/bubulle/travail/debian/rewrite/INTENT/roundcube/roundcube/debian/control	2007-05-11 07:36:10.109720098 +0200
@@ -11,10 +11,10 @@
 Architecture: all
 Depends: dbconfig-common, debconf | debconf-2.0, apache2 | httpd, php5 | php4, php5-mysql | php4-mysql | php5-pgsql | php4-pgsql | php5-sqlite | php4-sqlite, php5-mcrypt | php4-mcrypt, php-db, php-auth, php-net-smtp, php-net-socket, php-mail-mime, ucf, mysql-client | virtual-mysql-client | postgresql-client-8.1 | postgresql-client | sqlite, ${misc:Depends}
 Suggests: mysql-server | posgresql-server
-Description: modern, skinnable, AJAX based webmail solution for IMAP servers
+Description: skinnable, AJAX based, webmail solution for IMAP servers

Please, no advertisement in descriptions.....'modern' is subjective
and will certainly look silly in 10 years..:-)

  RoundCube Webmail is a browser-based multilingual IMAP client with an
- application-like user interface. It provides full functionality you
- expect from an e-mail client, including MIME support, address book,
+ application-like user interface. It provides full functionality
+ expected from an e-mail client, including MIME support, address book,
  folder manipulation and message filters.

Avoid "you" (even if being completely impersonal is not the best
option, I suggest avoiding too much personnalization when interacting
with users).



Template: roundcube/reconfigure-webserver
Type: multiselect
_Choices: apache, apache-ssl, apache-perl, apache2
Default: apache, apache-ssl, apache-perl, apache2
_Description: Web server(s) to configure automatically:
 RoundCube supports any web server supported by PHP, however only
 Apache can be configured automatically.
 .
 Please select the web server(s) that should be configured
 automatically for RoundCube.

Template: roundcube/restart-webserver
Type: boolean
Default: true
_Description: Should the webserver(s) be restartednow?
 In order to activate the new configuration, the reconfigured web
 servers have to be restarted.

Template: roundcube/hosts
Type: string
Default:
_Description: IMAP server(s) used with RoundCube:
 Please select the IMAP server that should be used with RoundCube.
 .
 If this is left blank, a text box will be displayed at
 login. Entering a space-separated list of hosts will display a
 pulldown menu. Entering a single host will enforce using this
 host.
 .
 To use SSL connections, please enter host names as 'ssl://hostname:993'.

Template: roundcube/language
Type: select
Choices: ${languages}
_Description: Default language:
 Please choose the default language for RoundCube.
 .
 This choice can be overridden by individual users in their preferences.
 .
 However, the default language will be used for the login screen and
 the first connection of users.
--- ../roundcube.old/debian/templates	2007-05-06 07:49:41.947884663 +0200
+++ debian/templates	2007-05-11 07:35:05.721269683 +0200
@@ -2,30 +2,40 @@
 Type: multiselect
 _Choices: apache, apache-ssl, apache-perl, apache2
 Default: apache, apache-ssl, apache-perl, apache2
-_Description: Webserver Reconfiguration:
- RoundCube supports any web server that php does, but this automatic
- configuration process only supports Apache. Please select which 
- apache version you want to configure the RoundCube frontend for.
+_Description: Web server(s) to configure automatically:
+ RoundCube supports any web server supported by PHP, however only
+ Apache can be configured automatically.
+ .
+ Please select the web server(s) that should be configured
+ automatically for RoundCube.
 
 Template: roundcube/restart-webserver
 Type: boolean
 Default: true
-_Description: Would you like to restart your webserver(s) now?
- Remember that in order to apply the changes your webserver(s) has/have to
- be restarted. 
+_Description: Should the webserver(s) be restartednow?
+ In order to activate the new configuration, the reconfigured web
+ servers have to be restarted.
 
 Template: roundcube/hosts
 Type: string
 Default:
-_Description: IMAP server on which RoundCube should connect to:
- Leave this field blank to show a textbox at login, give a list
- of space-separated hosts to display a pulldown menu or set one
- host. To use SSL connection, use ssl://hostname:993.
+_Description: IMAP server(s) used with RoundCube:
+ Please select the IMAP server that should be used with RoundCube.
+ .
+ If this is left blank, a text box will be displayed at
+ login. Entering a space-separated list of hosts will display a
+ pulldown menu. Entering a single host will enforce using this
+ host.
+ .
+ To use SSL connections, please enter host names as 'ssl://hostname:993'.
 
 Template: roundcube/language
 Type: select
 Choices: ${languages}
 _Description: Default language:
- Each user can select in his preferences the language of the
- interface. However, for the login screen and for the first
- connection, this is the language selected here that will be used.
+ Please choose the default language for RoundCube.
+ .
+ This choice can be overridden by individual users in their preferences.
+ .
+ However, the default language will be used for the login screen and
+ the first connection of users.
--- ../roundcube.old/debian/control	2007-05-06 07:49:41.943884633 +0200
+++ debian/control	2007-05-11 07:36:10.109720098 +0200
@@ -11,10 +11,10 @@
 Architecture: all
 Depends: dbconfig-common, debconf | debconf-2.0, apache2 | httpd, php5 | php4, php5-mysql | php4-mysql | php5-pgsql | php4-pgsql | php5-sqlite | php4-sqlite, php5-mcrypt | php4-mcrypt, php-db, php-auth, php-net-smtp, php-net-socket, php-mail-mime, ucf, mysql-client | virtual-mysql-client | postgresql-client-8.1 | postgresql-client | sqlite, ${misc:Depends}
 Suggests: mysql-server | posgresql-server
-Description: modern, skinnable, AJAX based webmail solution for IMAP servers
+Description: skinnable, AJAX based, webmail solution for IMAP servers
  RoundCube Webmail is a browser-based multilingual IMAP client with an
- application-like user interface. It provides full functionality you
- expect from an e-mail client, including MIME support, address book,
+ application-like user interface. It provides full functionality
+ expected from an e-mail client, including MIME support, address book,
  folder manipulation and message filters.
  .
  The user interface is fully skinnable using XHTML and CSS 2.
Source: roundcube
Section: web
Priority: extra
Maintainer: Debian Roundcube Maintainers <pkg-roundcube-maintainers@lists.alioth.debian.org>
Uploaders: Vincent Bernat <bernat@luffy.cx>, Romain Beauxis <toots@rastageeks.org>
Build-Depends: debhelper (>= 5), quilt, patchutils (>= 0.2.25), cdbs (>= 0.4.27-1)
Build-Depends-Indep: po-debconf
Standards-Version: 3.7.2

Package: roundcube
Architecture: all
Depends: dbconfig-common, debconf | debconf-2.0, apache2 | httpd, php5 | php4, php5-mysql | php4-mysql | php5-pgsql | php4-pgsql | php5-sqlite | php4-sqlite, php5-mcrypt | php4-mcrypt, php-db, php-auth, php-net-smtp, php-net-socket, php-mail-mime, ucf, mysql-client | virtual-mysql-client | postgresql-client-8.1 | postgresql-client | sqlite, ${misc:Depends}
Suggests: mysql-server | posgresql-server
Description: skinnable, AJAX based, webmail solution for IMAP servers
 RoundCube Webmail is a browser-based multilingual IMAP client with an
 application-like user interface. It provides full functionality
 expected from an e-mail client, including MIME support, address book,
 folder manipulation and message filters.
 .
 The user interface is fully skinnable using XHTML and CSS 2.
 .
  Homepage: http://www.roundcube.net/

Attachment: signature.asc
Description: Digital signature


Reply to: