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

Re: [RFR] templates://mysql-dfsg-5.0/{mysql-server-5.0.templates}



Christian Perrier wrote:
> - s/mysql/MySQL in the package description. Yes, the DevRef suggests
> that packages descriptions should begin with a lowercase letter, but
> the first word here is the noun of the product, so we really should
> use the official spelling and case...even here, IMHO.

Perhaps I should send a bugreport to the DevRef.  It doesn't need to
mention uppercase, as such; if short descriptions are noun phrases
rather than sentences, it follows that they don't need sentential
capitalisation or punctuation, but other uses of uppercase in
appositional phrases are unaffected ("I, Sam Hocevar, DPL-elect,
hereby...").  Notice also that the DevRef's example could be
rephrased as "the red-nosed reindeer, Rudolph". 

Diffs for one line in mysql-server-5.0/need_sarge_compat:

>  In old versions of MySQL clients on Debian, passwords were not stored
>  securely. This was improved since then, however clients (such as PHP)
>  from hosts running Debian 3.1 Sarge will not be able to connect to
>  recent accounts or accounts whose password have been changed.

Tenses: s/was/has been/
Punctuation: s/, however/; however,/
I considered recommending s/Sarge/(Sarge)/ here and elsewhere, but
both forms occur on official announcements, so never mind.  Appended
are the diff to the original, and amended version; here's the diff
to the RFR version: 

--- templates.rfr	2007-04-08 12:34:49.000000000 +0100
+++ templates.jbr	2007-04-08 12:38:18.000000000 +0100
@@ -69,7 +69,7 @@
 Default: false
 _Description: Support MySQL connections from hosts running Debian "sarge" or older?
  In old versions of MySQL clients on Debian, passwords were not stored
- securely. This was improved since then, however clients (such as PHP)
+ securely. This has been improved since then; however, clients (such as PHP)
  from hosts running Debian 3.1 Sarge will not be able to connect to
  recent accounts or accounts whose password have been changed.
  .
--- templates.orig	2007-04-08 13:06:00.000000000 +0100
+++ templates.jbr	2007-04-08 12:38:18.000000000 +0100
@@ -1,67 +1,80 @@
 Template: mysql-server-5.0/really_downgrade
 Type: boolean
 Default: false
-_Description: Do you really want to downgrade?
- WARNING: The file /var/lib/mysql/debian-*.flag exists. This indicates that a
- mysql-server package with a higher version has been installed before.
- It can not be guaranteed that this version can use its data.
+_Description: Really proceed with downgrade?
+ A file named /var/lib/mysql/debian-*.flag exists on this system.
+ .
+ Such file is an indication that a mysql-server package with a higher
+ version has been installed earlier.
+ .
+ There is no guarantee that the version you're currently installing
+ will be able to use the current databases.
 
 Template: mysql-server-5.0/nis_warning
 Type: note
-_Description: Important note for NIS/YP users!
- To use mysql you must install an equivalent user and group to the
- following and ensure yourself that /var/lib/mysql has the right
- permissions (the uid/gid may be different).
+#flag:translate!:3,5
+_Description: Important note for NIS/YP users
+ To use MySQL, the following entries for users and groups should be added
+ to the system:
  .
- /etc/passwd:      mysql:x:100:101:MySQL Server:/var/lib/mysql:/bin/false
+  /etc/passwd   : mysql:x:100:101:MySQL Server:/var/lib/mysql:/bin/false
+  /etc/group    : mysql:x:101:
  .
- /etc/group:       mysql:x:101:
+ You should also check the permissions and the owner of the
+ /var/lib/mysql file:
  .
- /var/lib/mysql:   drwxr-xr-x   mysql    mysql
+  /var/lib/mysql: drwxr-xr-x   mysql    mysql
 
 Template: mysql-server-5.0/postrm_remove_databases
 Type: boolean
 Default: false
-_Description: Remove the databases used by all MySQL versions?
- The script is about to remove the data directory /var/lib/mysql.
- If it is planned to just install a higher MySQL version or if a different
- mysql-server package is already using it, the data should be kept.
+_Description: Remove all MySQL databases?
+ The /var/lib/mysql directory which contains the MySQL databases is about
+ to be removed.
+ .
+ If you're removing the MySQL package in order to later install a more
+ recent version or if a different mysql-server package is already
+ using it, the data should be kept.
 
 Template: mysql-server-5.0/start_on_boot
 Type: boolean
 Default: true
-_Description: Should MySQL start on boot?
- The MySQL can start automatically on boot time or only if you manually
- type '/etc/init.d/mysql start'.
+_Description: Start the MySQL server on boot?
+ The MySQL server can be launched automatically at boot time or manually
+ with the '/etc/init.d/mysql start' command.
 
 Template: mysql-server/root_password
 Type: password
-_Description: New password for MySQL "root" user:
- It is highly recommended that you set a password for the MySQL administrative
- "root" user.
+_Description: New password for the MySQL "root" user:
+ While not mandatory, it is highly recommended that you set a password
+ for the MySQL administrative "root" user.
  .
- If you do not provide a password no changes will be made to the account.
+ If that field is left blank, the password will not be changed.
 
 Template: mysql-server/error_setting_password
 Type: error
-_Description: Unable to set password for MySQL "root" user
- It seems an error occurred while setting the password for the MySQL
- administrative user.  This may have happened because the user already
- has a password, or because there was a problem communicating with the
- MySQL server.
- .
- When installation finishes, you should verify that the account
- is properly protected with a password (see README.Debian for more
- information).
+_Description: Unable to set password for the MySQL "root" user
+ An error occurred while setting the password for the MySQL
+ administrative user. This may have happened because the account
+ already has a password, or because of a communication problem with
+ the MySQL server.
+ .
+ You should check the account's password after tha package installation.
+ .
+ Please read the /usr/share/doc/mysql-server-5.0/README.Debian file
+ for more information.
 
 Template: mysql-server-5.0/need_sarge_compat
 Type: boolean
 Default: false
 _Description: Support MySQL connections from hosts running Debian "sarge" or older?
- The way passwords were stored was not very secure. This has been improved
- with the drawback that clients (e.g. PHP) from hosts running Debian 3.1 Sarge
- will not be able to connect to account which are new or whose password have
- been changed. See /usr/share/doc/mysql-server-5.0/README.Debian.
+ In old versions of MySQL clients on Debian, passwords were not stored
+ securely. This has been improved since then; however, clients (such as PHP)
+ from hosts running Debian 3.1 Sarge will not be able to connect to
+ recent accounts or accounts whose password have been changed.
+ .
+ Please read the /usr/share/doc/mysql-server-5.0/README.Debian file
+ for more information.
 
 Template: mysql-server-5.0/need_sarge_compat_done
 Type: boolean
Template: mysql-server-5.0/really_downgrade
Type: boolean
Default: false
_Description: Really proceed with downgrade?
 A file named /var/lib/mysql/debian-*.flag exists on this system.
 .
 Such file is an indication that a mysql-server package with a higher
 version has been installed earlier.
 .
 There is no guarantee that the version you're currently installing
 will be able to use the current databases.

Template: mysql-server-5.0/nis_warning
Type: note
#flag:translate!:3,5
_Description: Important note for NIS/YP users
 To use MySQL, the following entries for users and groups should be added
 to the system:
 .
  /etc/passwd   : mysql:x:100:101:MySQL Server:/var/lib/mysql:/bin/false
  /etc/group    : mysql:x:101:
 .
 You should also check the permissions and the owner of the
 /var/lib/mysql file:
 .
  /var/lib/mysql: drwxr-xr-x   mysql    mysql

Template: mysql-server-5.0/postrm_remove_databases
Type: boolean
Default: false
_Description: Remove all MySQL databases?
 The /var/lib/mysql directory which contains the MySQL databases is about
 to be removed.
 .
 If you're removing the MySQL package in order to later install a more
 recent version or if a different mysql-server package is already
 using it, the data should be kept.

Template: mysql-server-5.0/start_on_boot
Type: boolean
Default: true
_Description: Start the MySQL server on boot?
 The MySQL server can be launched automatically at boot time or manually
 with the '/etc/init.d/mysql start' command.

Template: mysql-server/root_password
Type: password
_Description: New password for the MySQL "root" user:
 While not mandatory, it is highly recommended that you set a password
 for the MySQL administrative "root" user.
 .
 If that field is left blank, the password will not be changed.

Template: mysql-server/error_setting_password
Type: error
_Description: Unable to set password for the MySQL "root" user
 An error occurred while setting the password for the MySQL
 administrative user. This may have happened because the account
 already has a password, or because of a communication problem with
 the MySQL server.
 .
 You should check the account's password after tha package installation.
 .
 Please read the /usr/share/doc/mysql-server-5.0/README.Debian file
 for more information.

Template: mysql-server-5.0/need_sarge_compat
Type: boolean
Default: false
_Description: Support MySQL connections from hosts running Debian "sarge" or older?
 In old versions of MySQL clients on Debian, passwords were not stored
 securely. This has been improved since then; however, clients (such as PHP)
 from hosts running Debian 3.1 Sarge will not be able to connect to
 recent accounts or accounts whose password have been changed.
 .
 Please read the /usr/share/doc/mysql-server-5.0/README.Debian file
 for more information.

Template: mysql-server-5.0/need_sarge_compat_done
Type: boolean
Default: false
Description: for internal use
 Only internally used.


Reply to: