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

[RFR] templates://bugzilla/{bugzilla3.templates}



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

This review will last from Friday, July 31, 2009 to Monday, August 10, 2009.

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:
--- bugzilla.old/debian/bugzilla3.templates	2009-07-23 11:49:28.929121764 +0200
+++ bugzilla/debian/bugzilla3.templates	2009-07-31 09:47:32.971206775 +0200
@@ -14,7 +14,7 @@
 Template: bugzilla3/bugzilla_admin_name
 Type: string
 _Description: Email address of Bugzilla administrator:
- Please enter the email address of Bugzilla administrator; all mail for
+ Please enter the email address of the Bugzilla administrator; all mail for
  the administrator will be sent to this address. This email
  address is also used as the administrator login for Bugzilla.
  .

Missing article.

@@ -33,27 +33,29 @@
 Template: bugzilla3/customized_values
 Type: boolean
 Default: true
-_Description: Did you customized the Status/Resolutions values?
+_Description: Did you customize the Status/Resolutions values?

Spelling error

  If you customized values in the Status/Resolution field, you must
  edit /usr/share/bugzilla3/lib/checksetup_nondebian.pl before
- installation can continue.
+ the installation can continue.

Missing article

  .
- Because with each update a new version of the checksetup_nondebian.pl
- script is installed the /usr/share/bugzilla3/debian/pre-checksetup.d
- directory can be used to automaticaly apply your modification before
+ For each update of this package, a new version of the checksetup_nondebian.pl
+ script is installed; the /usr/share/bugzilla3/debian/pre-checksetup.d
+ directory can be used to automaticaly apply your modifications before
  execution.

Reformulate for clarity.

 
 Template: bugzilla3/customized_values_ask_again
 Type: boolean
 Default: false
-_Description: Do you want to be asked for customized Status/Resolution again?
+_Description: Prompt about customized Status/Resolution at each update?

Shorten the question and make it clearer (hopefully)

  If you modified Status/Resolution fields and created a script within
  /usr/share/bugzilla3/debian/pre-checksetup.pl to apply changes
- on /usr/share/bugzilla3/lib/checksetup-nondebian.pl you can negate this
- question. If you confirm to this question you have to call
- /usr/share/bugzilla3/lib/checksetup.pl yourself before using Bugzilla.
+ on /usr/share/bugzilla3/lib/checksetup-nondebian.pl, you may want to
+ avoid being prompted at each package upgrade.

"Negate this option" is kinda similar to "answer No" which is
discouraged (lintian) for various reasons (localisation, different
interfaces). I take it as not very clear, as well. For that reason, I
propose something different. If I understood well, the main  point is
avoiding being prompted, so let's say this that way.

  .
- If you did not modified Status/Resolution and do not intent to do so
- in the near future disagree with this question. checksetup.pl will be started
- automaticaly (together with the {pre,post}-checksetup.d scripts). If you
- change someday your mind do not forget to dpkg-reconfigure -phigh bugzilla3.
+ If you accept being prompted, you will have to call
+ /usr/share/bugzilla3/lib/checksetup.pl yourself, at each package
+ upgrade, before using Bugzilla.

Put the idea of "disagree with this question" into "if you accept
being prompted. Make it also very clear that this will have to happen
for each upgrade.


+ .
+ If you did not modify Status/Resolution, you should skip prompting as
+ checksetup.pl will be started
+ automaticaly (together with the {pre,post}-checksetup.d scripts).

And, finally, create a new paragraph for the last idea instead of
mixing it in the former one.

--- bugzilla.old/debian/control	2009-07-23 11:49:28.929121764 +0200
+++ bugzilla/debian/control	2009-07-31 09:14:34.105965367 +0200
@@ -52,11 +52,11 @@
  Bugzilla is a Bug Tracking System available through a web interface. 
  .
  It supports the following features:
-  - report bugs;
-  - assign bugs to the appropriate developers;
-  - prioritize bugs;
-  - set bug dependencies;
-  - arrange bugs by product and component.
+  * report bugs;
+  * assign bugs to the appropriate developers;
+  * prioritize bugs;
+  * set bug dependencies;
+  * arrange bugs by product and component.
  With these features, you can also use Bugzilla as a todo list manager.
  .
  Bugzilla is a web application that lets users report and look up existing bugs.

Use "standard" bullets (from a recent discussion in -devel).

-- 


# These templates have been reviewed by the debian-l10n-english
# team
#
# If modifications/additions/rewording are needed, please ask
# debian-l10n-english@lists.debian.org for advice.
#
# Even minor modifications require translation updates and such
# changes should be coordinated with translators and reviewers.

Template: bugzilla3/pwd_check
Type: password
_Description: Password confirmation:

Template: bugzilla3/bugzilla_admin_name
Type: string
_Description: Email address of Bugzilla administrator:
 Please enter the email address of the Bugzilla administrator; all mail for
 the administrator will be sent to this address. This email
 address is also used as the administrator login for Bugzilla.
 .
 A valid address must contain exactly one '@', and at least one '.' after
 the @. You'll be able to change this setting through Bugzilla's
 web interface.

Template: bugzilla3/bugzilla_admin_real_name
Type: string
_Description: Real name of Bugzilla administrator:

Template: bugzilla3/bugzilla_admin_pwd
Type: password
_Description: Password for the Bugzilla administrator account:

Template: bugzilla3/customized_values
Type: boolean
Default: true
_Description: Did you customize the Status/Resolutions values?
 If you customized values in the Status/Resolution field, you must
 edit /usr/share/bugzilla3/lib/checksetup_nondebian.pl before
 the installation can continue.
 .
 For each update of this package, a new version of the checksetup_nondebian.pl
 script is installed; the /usr/share/bugzilla3/debian/pre-checksetup.d
 directory can be used to automaticaly apply your modifications before
 execution.

Template: bugzilla3/customized_values_ask_again
Type: boolean
Default: false
_Description: Prompt about customized Status/Resolution at each update?
 If you modified Status/Resolution fields and created a script within
 /usr/share/bugzilla3/debian/pre-checksetup.pl to apply changes
 on /usr/share/bugzilla3/lib/checksetup-nondebian.pl, you may want to
 avoid being prompted at each package upgrade.
 .
 If you accept being prompted, you will have to call
 /usr/share/bugzilla3/lib/checksetup.pl yourself, at each package
 upgrade, before using Bugzilla.
 .
 If you did not modify Status/Resolution, you should skip prompting as
 checksetup.pl will be started
 automaticaly (together with the {pre,post}-checksetup.d scripts).
--- bugzilla.old/debian/bugzilla3.templates	2009-07-23 11:49:28.929121764 +0200
+++ bugzilla/debian/bugzilla3.templates	2009-07-31 09:57:17.583206835 +0200
@@ -14,7 +14,7 @@
 Template: bugzilla3/bugzilla_admin_name
 Type: string
 _Description: Email address of Bugzilla administrator:
- Please enter the email address of Bugzilla administrator; all mail for
+ Please enter the email address of the Bugzilla administrator; all mail for
  the administrator will be sent to this address. This email
  address is also used as the administrator login for Bugzilla.
  .
@@ -33,27 +33,29 @@
 Template: bugzilla3/customized_values
 Type: boolean
 Default: true
-_Description: Did you customized the Status/Resolutions values?
+_Description: Did you customize the Status/Resolutions values?
  If you customized values in the Status/Resolution field, you must
  edit /usr/share/bugzilla3/lib/checksetup_nondebian.pl before
- installation can continue.
+ the installation can continue.
  .
- Because with each update a new version of the checksetup_nondebian.pl
- script is installed the /usr/share/bugzilla3/debian/pre-checksetup.d
- directory can be used to automaticaly apply your modification before
+ For each update of this package, a new version of the checksetup_nondebian.pl
+ script is installed; the /usr/share/bugzilla3/debian/pre-checksetup.d
+ directory can be used to automaticaly apply your modifications before
  execution.
 
 Template: bugzilla3/customized_values_ask_again
 Type: boolean
 Default: false
-_Description: Do you want to be asked for customized Status/Resolution again?
+_Description: Prompt about customized Status/Resolution at each update?
  If you modified Status/Resolution fields and created a script within
  /usr/share/bugzilla3/debian/pre-checksetup.pl to apply changes
- on /usr/share/bugzilla3/lib/checksetup-nondebian.pl you can negate this
- question. If you confirm to this question you have to call
- /usr/share/bugzilla3/lib/checksetup.pl yourself before using Bugzilla.
+ on /usr/share/bugzilla3/lib/checksetup-nondebian.pl, you may want to
+ avoid being prompted at each package upgrade.
  .
- If you did not modified Status/Resolution and do not intent to do so
- in the near future disagree with this question. checksetup.pl will be started
- automaticaly (together with the {pre,post}-checksetup.d scripts). If you
- change someday your mind do not forget to dpkg-reconfigure -phigh bugzilla3.
+ If you accept being prompted, you will have to call
+ /usr/share/bugzilla3/lib/checksetup.pl yourself, at each package
+ upgrade, before using Bugzilla.
+ .
+ If you did not modify Status/Resolution, you should skip prompting as
+ checksetup.pl will be started
+ automaticaly (together with the {pre,post}-checksetup.d scripts).
--- bugzilla.old/debian/control	2009-07-23 11:49:28.929121764 +0200
+++ bugzilla/debian/control	2009-07-31 09:14:34.105965367 +0200
@@ -52,11 +52,11 @@
  Bugzilla is a Bug Tracking System available through a web interface. 
  .
  It supports the following features:
-  - report bugs;
-  - assign bugs to the appropriate developers;
-  - prioritize bugs;
-  - set bug dependencies;
-  - arrange bugs by product and component.
+  * report bugs;
+  * assign bugs to the appropriate developers;
+  * prioritize bugs;
+  * set bug dependencies;
+  * arrange bugs by product and component.
  With these features, you can also use Bugzilla as a todo list manager.
  .
  Bugzilla is a web application that lets users report and look up existing bugs.
Source: bugzilla
Section: web
Priority: optional
Maintainer: Raphael Bossek <bossekr@debian.org>
Build-Depends: po-debconf, debhelper (>= 5)
Build-Depends-Indep: debconf (>= 0.9.95) | debconf-2.0
Standards-Version: 3.8.2

Package: bugzilla3
Architecture: all
Section: web
Homepage: http://www.bugzilla.org
Depends: debconf (>= 0.9.95), 
         libtemplate-perl (>= 2.19-1),
         libappconfig-perl (>= 1.56-2),
         libtimedate-perl (>= 1.1600-9),
         libemail-send-perl (>= 2.192-1),
         libmail-sendmail-perl,
         libemail-mime-modifier-perl (>= 1.442-2),
         libemail-reply-perl (>= 1.202) | libemail-mime-creator-perl,
         libcgi-pm-perl (>= 3.33),
         libdbd-mysql-perl (>= 1.56-2) | libdbd-pg-perl, 
         apache2 | httpd,
         exim4 | mail-transport-agent,
         ucf (>= 0.08), patch, dbconfig-common (>= 1.8.27),
         mysql-client | postgresql-client,
         yui,
         ${misc:Depends}
Suggests: bugzilla3-doc,
          libnet-ldap-perl,
          libgd-text-perl,
          libgd-graph-perl, libgd-gd2-perl | libgd-noxpm-perl,
          libmailtools-perl (>= 1.77-1),
          libmime-tools-perl (>= 5.425-2),
          libhtml-parser-perl,
          libhtml-scrubber-perl,
          libxml-twig-perl,
          libauthen-radius-perl,
          graphviz,
          libsoap-lite-perl,
          patchutils,
          libwww-perl
Recommends: libchart-perl (>= 0.99c.pre3-0.1),
            libxml-parser-perl,
            perlmagick,
            mysql-server | postgresql,
            cvs,
            imagemagic
Conflicts: bugzilla (<< 3.0.0)
Replaces: bugzilla (<< 3.0.0)
Description: web-based bug tracking system
 Bugzilla is a Bug Tracking System available through a web interface. 
 .
 It supports the following features:
  * report bugs;
  * assign bugs to the appropriate developers;
  * prioritize bugs;
  * set bug dependencies;
  * arrange bugs by product and component.
 With these features, you can also use Bugzilla as a todo list manager.
 .
 Bugzilla is a web application that lets users report and look up existing bugs.
 Changes made to a bug's status are automatically sent to users concerned with
 it.

Package: bugzilla3-doc
Section: doc
Architecture: all
Suggests: bugzilla3
Depends: ${misc:Depends}
Homepage: http://www.bugzilla.org
Description: comprehensive guide to Bugzilla
 The Bugzilla Guide is a document (in ASCII text, HTML, and SGML format)
 discussing Bugzilla administration, maintenance, and use.

Attachment: signature.asc
Description: Digital signature


Reply to: