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

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



Please find, for review, the debconf templates and packages descriptions for the phpmyadmin 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:
--- ../phpmyadmin.old/debian/templates	2007-11-08 05:15:57.701382867 +0000
+++ debian/templates	2007-11-08 06:58:14.617944174 +0000
@@ -1,31 +1,34 @@
 Template: phpmyadmin/reconfigure-webserver
 Type: multiselect
 Choices: apache2, apache, apache-ssl, apache-perl, lighttpd
-Default:
 _Description: Web server to reconfigure automatically:
- phpMyAdmin supports any web server that PHP does, but this automatic
- configuration process only supports Apache.
+ Please choose the web server that should be automatically configured
+ to run phpMyAdmin.

Use the "standard" wording in such situation.

However, please note that apache, apache-ssl, apache-perl are deprecated.
 
 Template: phpmyadmin/setup-username
 Type: string
 Default: admin
-_Description: User name for web-based setup system:
- phpMyAdmin comes with a setup script that can help you with creating
- a configuration. The script is located at http://localhost/phpmyadmin/scripts/setup.php.
- For security reasons it requires authorization.
+_Description: Username for web-based setup system:
+ The setup system for phpMyAdmin may be used, after installation, from
+ http://localhost/phpmyadmin/scripts/setup.php.
+ .
+ Access to this system requires identification with a username and a
+ password.
  .
- Leave empty if you want to use the default user name 'admin'.
+ If you leave this field empty, the default username ('admin') will be used.

Avoid the leading lowercase letter in the first paragraph.

Rewrite for more standard use of English. Split in paragraphs to
improve readability.

 
 Template: phpmyadmin/setup-password
 Type: password
 Default:
 _Description: Password for web-based setup system:
- phpMyAdmin comes with a setup script that can help you with creating
- a configuration. The script is located at http://localhost/phpmyadmin/scripts/setup.php.
- For security reasons it requires authorization.
+ The setup system for phpMyAdmin may be used, after installation, from
+ http://localhost/phpmyadmin/scripts/setup.php.
  .
- You can manage the usernames and passwords with the `htpasswd' command.
- They are stored in the file /etc/phpmyadmin/htpasswd.setup
+ Access to this system requires identification with a username and a
+ password.
  .
- Leave empty if you want to disable access to the web-based setup.
-
+ Usernames and passwords may be managed with the `htpasswd' command and
+ are stored in /etc/phpmyadmin/htpasswd.setup.
+ .
+ If you leave this field empty, access to the web-based setup will be
+ disabled.


About the same changes.

--- ../phpmyadmin.old/debian/control	2007-11-08 05:15:57.701382867 +0000
+++ debian/control	2007-11-09 06:55:37.324263089 +0000
@@ -14,29 +14,30 @@
 Depends: libapache2-mod-php5 | libapache-mod-php5 | php5-cgi | php5 | libapache2-mod-php4 | libapache-mod-php4 | php4 | php4-cgi, php5-mysql | php5-mysqli | php4-mysql, php5-mcrypt | php4-mcrypt, perl, ${misc:Depends}
 Recommends: apache2 | lighttpd | httpd, php5-gd | php4-gd
 Suggests: mysql-server
-Description: Administrate MySQL over the WWW
- phpMyAdmin is intended to handle the administration of MySQL over the WWW.
- Currently it can:
-   - easily browse through databases and tables
-   - create, copy, rename, alter and drop databases
-   - create, copy, rename, alter and drop tables
-   - do table maintenance
-   - add, edit and drop fields
-   - execute any SQL-statement, even multiple queries
-   - create, alter and drop indexes
-   - load text files into tables
-   - create and read dumps of tables or databases
-   - export data to SQL, CSV, XML, Word, Excel, PDF and Latex formats
-   - administer multiple servers
-   - manage MySQL users and privileges
-   - check server settings and runtime information with configuration hints
-   - check referential integrity in MyISAM tables
-   - using Query-by-example (QBE), create complex queries automatically
-     connecting required tables
-   - create PDF graphics of your Database layout
-   - search globally in a database or a subset of it
-   - transform stored data into any format using a set of predefined
-     functions, like displaying BLOB-data as image or download-link
-   - support InnoDB tables and foreign keys
-   - support mysqli, the improved MySQL extension
-   - communicate in 50 different languages
+Description: MySQL web administration tool

Avoid a sentence in synopsis

+ This package allows administering of MySQL with a web interface.

Avoid leading lowercase letter

+ .
+ Features:
+  - browse through databases and tables;

.../...

standard enumeration style (only two leading spaces), semi-colons and
final dot.

That enumeration could be standardized better, maybe (only verbs, or
only nouns). I'm not sure it's worth it, though.


Template: phpmyadmin/reconfigure-webserver
Type: multiselect
Choices: apache2, apache, apache-ssl, apache-perl, lighttpd
_Description: Web server to reconfigure automatically:
 Please choose the web server that should be automatically configured
 to run phpMyAdmin.

Template: phpmyadmin/setup-username
Type: string
Default: admin
_Description: Username for web-based setup system:
 The setup system for phpMyAdmin may be used, after installation, from
 http://localhost/phpmyadmin/scripts/setup.php.
 .
 Access to this system requires identification with a username and a
 password.
 .
 If you leave this field empty, the default username ('admin') will be used.

Template: phpmyadmin/setup-password
Type: password
Default:
_Description: Password for web-based setup system:
 The setup system for phpMyAdmin may be used, after installation, from
 http://localhost/phpmyadmin/scripts/setup.php.
 .
 Access to this system requires identification with a username and a
 password.
 .
 Usernames and passwords may be managed with the `htpasswd' command and
 are stored in /etc/phpmyadmin/htpasswd.setup.
 .
 If you leave this field empty, access to the web-based setup will be
 disabled.
--- ../phpmyadmin.old/debian/templates	2007-11-08 05:15:57.701382867 +0000
+++ debian/templates	2007-11-08 06:58:14.617944174 +0000
@@ -1,31 +1,34 @@
 Template: phpmyadmin/reconfigure-webserver
 Type: multiselect
 Choices: apache2, apache, apache-ssl, apache-perl, lighttpd
-Default:
 _Description: Web server to reconfigure automatically:
- phpMyAdmin supports any web server that PHP does, but this automatic
- configuration process only supports Apache.
+ Please choose the web server that should be automatically configured
+ to run phpMyAdmin.
 
 Template: phpmyadmin/setup-username
 Type: string
 Default: admin
-_Description: User name for web-based setup system:
- phpMyAdmin comes with a setup script that can help you with creating
- a configuration. The script is located at http://localhost/phpmyadmin/scripts/setup.php.
- For security reasons it requires authorization.
+_Description: Username for web-based setup system:
+ The setup system for phpMyAdmin may be used, after installation, from
+ http://localhost/phpmyadmin/scripts/setup.php.
+ .
+ Access to this system requires identification with a username and a
+ password.
  .
- Leave empty if you want to use the default user name 'admin'.
+ If you leave this field empty, the default username ('admin') will be used.
 
 Template: phpmyadmin/setup-password
 Type: password
 Default:
 _Description: Password for web-based setup system:
- phpMyAdmin comes with a setup script that can help you with creating
- a configuration. The script is located at http://localhost/phpmyadmin/scripts/setup.php.
- For security reasons it requires authorization.
+ The setup system for phpMyAdmin may be used, after installation, from
+ http://localhost/phpmyadmin/scripts/setup.php.
  .
- You can manage the usernames and passwords with the `htpasswd' command.
- They are stored in the file /etc/phpmyadmin/htpasswd.setup
+ Access to this system requires identification with a username and a
+ password.
  .
- Leave empty if you want to disable access to the web-based setup.
-
+ Usernames and passwords may be managed with the `htpasswd' command and
+ are stored in /etc/phpmyadmin/htpasswd.setup.
+ .
+ If you leave this field empty, access to the web-based setup will be
+ disabled.
--- ../phpmyadmin.old/debian/control	2007-11-08 05:15:57.701382867 +0000
+++ debian/control	2007-11-09 06:55:37.324263089 +0000
@@ -14,29 +14,30 @@
 Depends: libapache2-mod-php5 | libapache-mod-php5 | php5-cgi | php5 | libapache2-mod-php4 | libapache-mod-php4 | php4 | php4-cgi, php5-mysql | php5-mysqli | php4-mysql, php5-mcrypt | php4-mcrypt, perl, ${misc:Depends}
 Recommends: apache2 | lighttpd | httpd, php5-gd | php4-gd
 Suggests: mysql-server
-Description: Administrate MySQL over the WWW
- phpMyAdmin is intended to handle the administration of MySQL over the WWW.
- Currently it can:
-   - easily browse through databases and tables
-   - create, copy, rename, alter and drop databases
-   - create, copy, rename, alter and drop tables
-   - do table maintenance
-   - add, edit and drop fields
-   - execute any SQL-statement, even multiple queries
-   - create, alter and drop indexes
-   - load text files into tables
-   - create and read dumps of tables or databases
-   - export data to SQL, CSV, XML, Word, Excel, PDF and Latex formats
-   - administer multiple servers
-   - manage MySQL users and privileges
-   - check server settings and runtime information with configuration hints
-   - check referential integrity in MyISAM tables
-   - using Query-by-example (QBE), create complex queries automatically
-     connecting required tables
-   - create PDF graphics of your Database layout
-   - search globally in a database or a subset of it
-   - transform stored data into any format using a set of predefined
-     functions, like displaying BLOB-data as image or download-link
-   - support InnoDB tables and foreign keys
-   - support mysqli, the improved MySQL extension
-   - communicate in 50 different languages
+Description: MySQL web administration tool
+ This package allows administering of MySQL with a web interface.
+ .
+ Features:
+  - browse through databases and tables;
+  - create, copy, rename, alter and drop databases;
+  - create, copy, rename, alter and drop tables;
+  - table maintenance;
+  - add, edit and drop fields;
+  - execute any SQL-statement, even multiple queries;
+  - create, alter and drop indexes;
+  - load text files into tables;
+  - create and read dumps of tables or databases;
+  - export data to SQL, CSV, XML, Word, Excel, PDF and LaTeX formats;
+  - administer multiple servers;
+  - manage MySQL users and privileges;
+  - check server settings and runtime information with configuration hints;
+  - check referential integrity in MyISAM tables;
+  - using Query-by-example (QBE), create complex queries automatically
+    connecting required tables;
+  - create PDF graphics of database layout;
+  - search globally in a database or a subset of it;
+  - transform stored data into any format using a set of predefined
+    functions, such as displaying BLOB-data as image or download-link;
+  - support InnoDB tables and foreign keys;
+  - support mysqli, the improved MySQL extension;
+  - fully internationalized and localized in several languages.
Source: phpmyadmin
Maintainer: Thijs Kinkhorst <thijs@debian.org>
Uploaders: Michal Čihař <nijel@debian.org>
Section: web
Priority: extra
Standards-Version: 3.7.2
Build-Depends: debhelper (>= 5), dpatch, po-debconf
Homepage: http://www.phpmyadmin.net/
Vcs-Browser: https://aphrodite.kinkhorst.nl/wsvn/debian/phpmyadmin/
Vcs-Svn: https://svn.kinkhorst.nl/svn/debian/phpmyadmin/trunk

Package: phpmyadmin
Architecture: all
Depends: libapache2-mod-php5 | libapache-mod-php5 | php5-cgi | php5 | libapache2-mod-php4 | libapache-mod-php4 | php4 | php4-cgi, php5-mysql | php5-mysqli | php4-mysql, php5-mcrypt | php4-mcrypt, perl, ${misc:Depends}
Recommends: apache2 | lighttpd | httpd, php5-gd | php4-gd
Suggests: mysql-server
Description: MySQL web administration tool
 This package allows administering of MySQL with a web interface.
 .
 Features:
  - browse through databases and tables;
  - create, copy, rename, alter and drop databases;
  - create, copy, rename, alter and drop tables;
  - table maintenance;
  - add, edit and drop fields;
  - execute any SQL-statement, even multiple queries;
  - create, alter and drop indexes;
  - load text files into tables;
  - create and read dumps of tables or databases;
  - export data to SQL, CSV, XML, Word, Excel, PDF and LaTeX formats;
  - administer multiple servers;
  - manage MySQL users and privileges;
  - check server settings and runtime information with configuration hints;
  - check referential integrity in MyISAM tables;
  - using Query-by-example (QBE), create complex queries automatically
    connecting required tables;
  - create PDF graphics of database layout;
  - search globally in a database or a subset of it;
  - transform stored data into any format using a set of predefined
    functions, such as displaying BLOB-data as image or download-link;
  - support InnoDB tables and foreign keys;
  - support mysqli, the improved MySQL extension;
  - fully internationalized and localized in several languages.

Attachment: signature.asc
Description: Digital signature


Reply to: