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

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



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

This review will last from Tuesday, June 19, 2007 to Friday, June 29, 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:

--- myphpmoney.old/debian/templates	2007-06-10 08:18:55.274814766 +0200
+++ myphpmoney/debian/templates	2007-06-14 07:56:37.265186767 +0200
@@ -2,11 +2,11 @@
 Type: boolean
 Default: false
 _Description: Do you want to configure MyPhpMoney now?
- MyPhpMoney needs to be configured before its use, i.e. the MySQL database
- should be created and the Apache Web Server should be configured.
+ MyPhpMoney needs to be configured before its use: the MySQL database
+ should be created and the Apache web server should be configured.

Overall consistency: we try to avoid "i.e." and related latin-based
locution who might not be obvious for all readers.

uncapitalization

  .
- For that you will need the username and the password of your MySQL
- database administrator.
+ To achieve this, you will need to provide the username and the
+ password of your the MySQL database server administrator.

Tentative for unfrenglishization. Might be unsuccessful..:-)

oh, "your the" spotted..:-)...so is "username" which should be "login name"
Corrected in my copy
  .
  If you want to configure it later, you should run 'dpkg-reconfigure
  myphpmoney'.
@@ -15,70 +15,74 @@
 Type: multiselect
 Choices: ${webservers}
 Default: apache, apache-ssl, apache-perl, apache2
-_Description: Please select which Web Server you want to use for MyPhpMoney
- MyPhpMoney currently only supports Apache type Web Servers.
+_Description: Web server to use with MyPhpMoney:
+ MyPhpMoney currently only supports Apache-like web servers.

Use a colon-ended prompt for all select/multiselect. As it is obvious
that selections should be done, just don't repeat "Please select" in
the short desc.

"better" writing and consistency

 
 Template: myphpmoney/databasemgr_server
 Type: string
 Default: localhost
-_Description: What is the hostname where your database is running?
- If your database is on another machine besides the one that MyPhpMoney is
- running on then you need to change this value to the fully qualified
- domain name for that system.  If you wish to access it locally, simply
- use "localhost" here.
+_Description: Database server host name:

No interrogative form.


+ The database for MyPhpMoney may be hosted on a remote server.
+ .
+ Please enter the fully qualified domain name for that system.
+ .
+ If the database is hosted locally, please enter 'localhost'.

Split out in paragraphs for readability. The database is not "your"
database. General unfrenglishization.

 
 Template: myphpmoney/database_name
 Type: string
 Default: myphpmoney
-_Description: What name do you want for your MyPhpMoney database?
- This is where all the MyPhpMoney data will be stored.
+_Description: MyPhpMoney database name:
+ Please enter the name of the database where MyPhpMoney data will be stored.

Never ever use "This is" in log descriptions. It needs displaying both
descriptions together which does not always happen.

Again, removal of interrogative form.

General comment for other templates: this package *should* use
dbconfig-common.
 
 
 Template: myphpmoney/postrm_remove_database
 Type: boolean
 Default: false
-_Description: Remove database after "purging" the myphpmoney package?
- Should I remove the database when you purge the myphpmoney package with
- the "dpkg --purge myphpmoney" command (i.e.  remove everything including
- the configuration) later on? (default is not)
+_Description: Remove database after purging the myphpmoney package?
+ Please choose whether MyPhPMoney's database should be removed when
+ the myphpmoney package is purged.

Be simple and direct.


--- myphpmoney.old/debian/control	2007-06-10 08:18:55.274814766 +0200
+++ myphpmoney/debian/control	2007-06-15 07:52:27.189474883 +0200
@@ -9,17 +9,16 @@
 Architecture: all
 Depends: apache (>= 1.3.29.0.1-1) | apache-ssl (>= 1.3.29.0.1-1) | apache-perl (>= 1.3.29.0.1-1) | httpd, php4 (>= 4.0.3pl1) | php4-cgi (>= 4.0.3pl1) | libapache-mod-php4 | libapache2-mod-php4, php4-mysql, php4-gd, mysql-client, wwwconfig-common (>= 0.0.19), ttf-bitstream-vera, ${misc:Depends}
 Recommends: mysql-server-4.1 | mysql-server-5.0
-Description: Finance manager written in PHP
- MyPhpMoney is a finance manager written in PHP. It consists of 6 modules:
-   * Count book (to enter your operations and balance your accounts) ;
-   * Schedule of payments (to allow you to know the date due on your 
-     coming payments) ;
-   * Operation and Recipient (to see a summary of operations, with the 
-     origin and the destination of your money) ;
-   * Loan simulation
-   * Backup MySql 
-   * Options & Configuration.
+Description: finance manager

Users don't care that it's written in PHP, indeed..:-)

+ MyPhpMoney includes 6 modules:
+  - Count book (to enter operations and balance accounts);
+  - Payment schedule (to run a scheduler for upcoming payments);
+  - Operation and recipient (to see a summary of operations, with the 
+    origin and the destination of the money) ;
+  - Loan simulation
+  - Database backup
+  - Options and configuration.

Reformat with generally accepted bulleting method. No french typography.

  .
- It runs using Apache for web server and MySQL for the database.
+ It needs an Apache web server and MySQL as database server software.

Unfrenglish..:-)


Template: myphpmoney/configuration
Type: boolean
Default: false
_Description: Do you want to configure MyPhpMoney now?
 MyPhpMoney needs to be configured before its use: the MySQL database
 should be created and the Apache web server should be configured.
 .
 To achieve this, you will need to provide the login name and the
 password of the MySQL database server administrator.
 .
 If you want to configure it later, you should run 'dpkg-reconfigure
 myphpmoney'.

Template: myphpmoney/webservers
Type: multiselect
Choices: ${webservers}
Default: apache, apache-ssl, apache-perl, apache2
_Description: Web server to use with MyPhpMoney:
 MyPhpMoney currently only supports Apache-like web servers.

Template: myphpmoney/databasemgr_server
Type: string
Default: localhost
_Description: Database server host name:
 The database for MyPhpMoney may be hosted on a remote server.
 .
 Please enter the fully qualified domain name for that system.
 .
 If the database is hosted locally, please enter 'localhost'.

Template: myphpmoney/database_name
Type: string
Default: myphpmoney
_Description: MyPhpMoney database name:
 Please enter the name of the database where MyPhpMoney data will be stored.

Template: myphpmoney/mysql_user
Type: string
Default: myphpmoney
_Description: MySQL database login name:
 Please enter the MySQL login name to use for accessing MyPhpMoney's
 database.
 .
 It will be created if it doesn't already exist.
 .
 Please note that the database server software must be configured to allow
 password authentication.

Template: myphpmoney/database_pass
Type: password
_Description: MySQL database password:
 Please enter the password for the MySQL login name that will be used to
 access MyPhpMoney's database. Leave this blank for not using a password.

Template: myphpmoney/mysql_dbadmin
Type: string
Default: root
_Description: MySQL database server administrator:
 Please enter the database server administrator's login name. MySQL 
 database server software generally uses 'root'.

Template: myphpmoney/dbadmpass
Type: password
_Description: MySQL database server administrator password:
 Please enter the database server administrator's password.

Template: myphpmoney/dbcreateerror
Type: error
_Description: MyPhpMoney database creation failusre
 The MyPhpMoney installation program failed to properly set up a database.
 Please make sure all of parameters you supplied are correct and that
 the your database server software is running.
 .
 Please re-installl MyPhpMoney to create the database.

# Debconf abuse
Template: myphpmoney/installed
Type: note
_Description: MyPhpMoney installed
 MyPhpMoney setup was successfully completed. You can now test MyPhpMoney
 by pointing a web browser to ${site}.

Template: myphpmoney/postrm_remove_database
Type: boolean
Default: false
_Description: Remove database after purging the myphpmoney package?
 Please choose whether MyPhPMoney's database should be removed when
 the myphpmoney package is purged.
--- ../myphpmoney.old/debian/templates	2007-06-10 08:18:55.274814766 +0200
+++ debian/templates	2007-06-14 07:56:37.265186767 +0200
@@ -2,11 +2,11 @@
 Type: boolean
 Default: false
 _Description: Do you want to configure MyPhpMoney now?
- MyPhpMoney needs to be configured before its use, i.e. the MySQL database
- should be created and the Apache Web Server should be configured.
+ MyPhpMoney needs to be configured before its use: the MySQL database
+ should be created and the Apache web server should be configured.
  .
- For that you will need the username and the password of your MySQL
- database administrator.
+ To achieve this, you will need to provide the username and the
+ password of your the MySQL database server administrator.
  .
  If you want to configure it later, you should run 'dpkg-reconfigure
  myphpmoney'.
@@ -15,70 +15,74 @@
 Type: multiselect
 Choices: ${webservers}
 Default: apache, apache-ssl, apache-perl, apache2
-_Description: Please select which Web Server you want to use for MyPhpMoney
- MyPhpMoney currently only supports Apache type Web Servers.
+_Description: Web server to use with MyPhpMoney:
+ MyPhpMoney currently only supports Apache-like web servers.
 
 Template: myphpmoney/databasemgr_server
 Type: string
 Default: localhost
-_Description: What is the hostname where your database is running?
- If your database is on another machine besides the one that MyPhpMoney is
- running on then you need to change this value to the fully qualified
- domain name for that system.  If you wish to access it locally, simply
- use "localhost" here.
+_Description: Database server host name:
+ The database for MyPhpMoney may be hosted on a remote server.
+ .
+ Please enter the fully qualified domain name for that system.
+ .
+ If the database is hosted locally, please enter 'localhost'.
 
 Template: myphpmoney/database_name
 Type: string
 Default: myphpmoney
-_Description: What name do you want for your MyPhpMoney database?
- This is where all the MyPhpMoney data will be stored.
+_Description: MyPhpMoney database name:
+ Please enter the name of the database where MyPhpMoney data will be stored.
 
 Template: myphpmoney/mysql_user
 Type: string
 Default: myphpmoney
-_Description: What is your MySQL database username?
- What username will access the MySQL database for MyPhpMoney?  This user
- will be created if it doesn't already exist.  Note that your database
- manager must be configured to allow password authentication or MyPhpMoney
- will not work.
+_Description: MySQL database login name:
+ Please enter the MySQL login name to use for accessing MyPhpMoney's
+ database.
+ .
+ It will be created if it doesn't already exist.
+ .
+ Please note that the database server software must be configured to allow
+ password authentication.
 
 Template: myphpmoney/database_pass
 Type: password
-_Description: What is the password you wish to use for the database user?
- Enter a password for the database user (leave blank for no password). This
- is the password that will be used along with the database user name you
- have already supplied to connect to the database.
+_Description: MySQL database password:
+ Please enter the password for the MySQL login name that will be used to
+ access MyPhpMoney's database. Leave this blank for not using a password.
 
 Template: myphpmoney/mysql_dbadmin
 Type: string
 Default: root
-_Description: Enter the username of your MySQL database administrator.
- This is the database admin username used to create MyPhpMoney database and
- user.  For MySQL databases, this is usually "root".
+_Description: MySQL database server administrator:
+ Please enter the database server administrator's login name. MySQL 
+ database server software generally uses 'root'.
 
 Template: myphpmoney/dbadmpass
 Type: password
-_Description: What is your admin database password?
- Enter the password for your database admin user to access the database.
+_Description: MySQL database server administrator password:
+ Please enter the database server administrator's password.
 
 Template: myphpmoney/dbcreateerror
-Type: note
-_Description: Error: failed to set up MyPhpMoney database properly !
- MyPhpMoney installation program failed to set up a database properly for
- its needs.  Please make sure all of parameters you supplied are correct
- and that your database manager is running.  Install MyPhpMoney again to
- make it working.
+Type: error
+_Description: MyPhpMoney database creation failusre
+ The MyPhpMoney installation program failed to properly set up a database.
+ Please make sure all of parameters you supplied are correct and that
+ the your database server software is running.
+ .
+ Please re-installl MyPhpMoney to create the database.
 
+# Debconf abuse
 Template: myphpmoney/installed
 Type: note
-_Description: MyPhpMoney is now installed
- MyPhpMoney setup was successfully completed.  You can now test MyPhpMoney
- by using your favourite browser to visit ${site}.
+_Description: MyPhpMoney installed
+ MyPhpMoney setup was successfully completed. You can now test MyPhpMoney
+ by pointing a web browser to ${site}.
 
 Template: myphpmoney/postrm_remove_database
 Type: boolean
 Default: false
-_Description: Remove database after "purging" the myphpmoney package?
- Should I remove the database when you purge the myphpmoney package with
- the "dpkg --purge myphpmoney" command (i.e.  remove everything including
- the configuration) later on? (default is not)
+_Description: Remove database after purging the myphpmoney package?
+ Please choose whether MyPhPMoney's database should be removed when
+ the myphpmoney package is purged.
--- ../myphpmoney.old/debian/control	2007-06-10 08:18:55.274814766 +0200
+++ debian/control	2007-06-19 16:09:56.820543359 +0200
@@ -9,17 +9,16 @@
 Architecture: all
 Depends: apache (>= 1.3.29.0.1-1) | apache-ssl (>= 1.3.29.0.1-1) | apache-perl (>= 1.3.29.0.1-1) | httpd, php4 (>= 4.0.3pl1) | php4-cgi (>= 4.0.3pl1) | libapache-mod-php4 | libapache2-mod-php4, php4-mysql, php4-gd, mysql-client, wwwconfig-common (>= 0.0.19), ttf-bitstream-vera, ${misc:Depends}
 Recommends: mysql-server-4.1 | mysql-server-5.0
-Description: Finance manager written in PHP
- MyPhpMoney is a finance manager written in PHP. It consists of 6 modules:
-   * Count book (to enter your operations and balance your accounts) ;
-   * Schedule of payments (to allow you to know the date due on your 
-     coming payments) ;
-   * Operation and Recipient (to see a summary of operations, with the 
-     origin and the destination of your money) ;
-   * Loan simulation
-   * Backup MySql 
-   * Options & Configuration.
+Description: finance manager
+ MyPhpMoney includes 6 modules:
+  - Count book (to enter operations and balance accounts);
+  - Payment schedule (to run a scheduler for upcoming payments);
+  - Operation and recipient (to see a summary of operations, with the 
+    origin and the destination of the money) ;
+  - Loan simulation
+  - Database backup
+  - Options and configuration.
  .
- It runs using Apache for web server and MySQL for the database.
+ It needs an Apache web server and MySQL as database server software.
  .
   Homepage: http://myphpmoney.sourceforge.net
Source: myphpmoney
Section: utils
Priority: optional
Maintainer: Debian QA Group <packages@qa.debian.org>
Build-Depends: debhelper (>> 4.1.16)
Standards-Version: 3.7.2

Package: myphpmoney
Architecture: all
Depends: apache (>= 1.3.29.0.1-1) | apache-ssl (>= 1.3.29.0.1-1) | apache-perl (>= 1.3.29.0.1-1) | httpd, php4 (>= 4.0.3pl1) | php4-cgi (>= 4.0.3pl1) | libapache-mod-php4 | libapache2-mod-php4, php4-mysql, php4-gd, mysql-client, wwwconfig-common (>= 0.0.19), ttf-bitstream-vera, ${misc:Depends}
Recommends: mysql-server-4.1 | mysql-server-5.0
Description: finance manager
 MyPhpMoney includes 6 modules:
  - Count book (to enter operations and balance accounts);
  - Payment schedule (to run a scheduler for upcoming payments);
  - Operation and recipient (to see a summary of operations, with the 
    origin and the destination of the money) ;
  - Loan simulation
  - Database backup
  - Options and configuration.
 .
 It needs an Apache web server and MySQL as database server software.
 .
  Homepage: http://myphpmoney.sourceforge.net

Attachment: signature.asc
Description: Digital signature


Reply to: