Bug#455772: apt-listchanges: [debconf_rewrite] Debconf templates and debian/control review

2007-12-13 Thread Christian Perrier
Quoting Justin B Rye ([EMAIL PROTECTED]):
 Christian Perrier wrote:
  Justin, could you have a look at it?
 
 Sure.


After reworking the templates from your suggestion, here's the file I
come up with.

Pierre, translations are coming in already because the call for
updates was sent.

As we're re-changing the templates file, we'll need another call for
translation updates. So, in short, don't commit anything right now. I
will anyway come up with a full patch at the end of the final
translation update round.


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

Template: apt-listchanges/frontend
Type: select
__Choices: pager, browser, xterm-pager, xterm-browser, gtk, text, mail, none
Default: pager
_Description: Method to be used to display changes:
 Package changes may be displayed by apt-listchanges
 in various ways.
 .
  pager: display changes one page at a time;
  browser  : display HTML-formatted changes using a web browser;
  xterm-pager  : like pager, but in an xterm in the background;
  xterm-browser: like browser, but in an xterm in the background;
  gtk  : display changes in a GTK window;
  text : print changes to the terminal (without pausing);
  mail : only send changes via e-mail;
  none : do not run automatically from APT.
 .
 This setting can be overridden at execution time. By default, all the
 options except for 'none' will also send copies by mail.

Template: apt-listchanges/email-address
Type: string
Default: root
_Description: E-mail address(es) which will receive changes:
 Optionally, apt-listchanges can e-mail a copy of displayed changes to
 a specified address.
 .
 Multiple addresses may be specified, delimited by commas. Leaving this
 field empty disables mail notifications.

Template: apt-listchanges/confirm
Type: boolean
Default: false
_Description: Prompt for confirmation after displaying changes?
 After displaying the list of changes, apt-listchanges can pause with
 a confirmation prompt. This is useful when running from APT, as it
 offers an opportunity to abort the upgrade if a change is unwelcome.
 .
 This can be overridden at execution time, and has no effect if the
 configured frontend option is 'mail' or 'none'.

Template: apt-listchanges/save-seen
Type: boolean
Default: true
_Description: Should apt-listchanges skip changes that have already been seen?
 A record of already displayed changes can be kept in order to avoid
 displaying them again. This is useful, for example, when retrying an upgrade.

Template: apt-listchanges/which
Type: select
__Choices: news, changelogs, both
Default: news
_Description: Changes displayed with APT:
 Please choose which type of changes should be displayed with APT.
 .
  news  : important news items only;
  changelogs: detailed changelogs only;
  both  : news and changelogs.


signature.asc
Description: Digital signature


Bug#455772: apt-listchanges: [debconf_rewrite] Debconf templates and debian/control review

2007-12-12 Thread Christian Perrier
Quoting Christian Perrier ([EMAIL PROTECTED]):
 Package: apt-listchanges
 Version: N/A
 Severity: normal
 Tags: patch
 
 Dear Debian maintainer,
 
 On Monday, November 26, 2007, I notified you of the beginning of a review 
 process
 concerning debconf templates for apt-listchanges.
 
 The debian-l10n-english contributors have now reviewed these templates,
 and the proposed changes are attached to this bug report.
 
 Please review the suggested changes are suggested, and if you have any
 objections, let me know in the next 3 days.


After the call for translations, Frans Pop commented the new templates
and noticed that several wordings are questionable.

From his comments, I came up with a revamped templates file, which I
attach to this mail.

Justin, could you have a look at it?



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

Template: apt-listchanges/frontend
Type: select
__Choices: pager, browser, xterm-pager, xterm-browser, gtk, text, mail, none
Default: pager
_Description: Method to be used to display changes:
 Package changes may be displayed by apt-listchanges
 in various ways.
 .
  pager: display changes one page at a time;
  browser  : display HTML-formatted changes using a web browser;
  xterm-pager  : like pager, but in an xterm in the background;
  xterm-browser: like browser, but in an xterm in the background;
  gtk  : display changes in a GTK window;
  text : print changes to the terminal (without pausing);
  mail : only send changes via mail;
  none : do not run automatically from APT.
 .
 This setting can be overridden at execution time. Mail copies of
 the changes list will also be sent except when choosing 'none'.

Template: apt-listchanges/email-address
Type: string
Default: root
_Description: E-mail address(es) which will receive changes:
 Optionally, apt-listchanges can e-mail a copy of displayed changes to
 a specified address.
 .
 Multiple addresses may be specified, delimited by commas. Leaving this
 field empty disables mail notifications.

Template: apt-listchanges/confirm
Type: boolean
Default: false
_Description: Prompt for confirmation after displaying changes?
 After displaying the list of changes, apt-listchanges can pause with
 a confirmation prompt. This is useful when running from APT, as it
 offers an opportunity to abort the upgrade if a change is unwelcome.
 .
 This setting does not apply to the 'mail' or 'none' settings, and can be
 overridden at execution time.

Template: apt-listchanges/save-seen
Type: boolean
Default: true
_Description: Should apt-listchanges skip changes that have already been seen?
 A record of already displayed changes can be kept in order to avoid
 displaying them again. This is useful, for example, when retrying an upgrade.

Template: apt-listchanges/which
Type: select
__Choices: news, changelogs, both
Default: news
_Description: Changes displayed with APT:
 Please choose which type of changes should be displayed with APT.
 .
  news  : important news items only;
  changelogs: detailed changelogs only;
  both  : news and changelogs.


signature.asc
Description: Digital signature


Bug#455772: apt-listchanges: [debconf_rewrite] Debconf templates and debian/control review

2007-12-12 Thread Justin B Rye
Christian Perrier wrote:
 Justin, could you have a look at it?

Sure.

 Template: apt-listchanges/frontend
[...]
 _Description: Method to be used to display changes:
  Package changes may be displayed by apt-listchanges
  in various ways.

Yes, I like this.

[...]
   mail : only send changes via mail;

(My own suggestion here was to say only send changes via e-mail,
but I didn't notice that this was dropped in the LCFC.)

[...]
  This setting can be overridden at execution time. Mail copies of
  the changes list will also be sent except when choosing 'none'.

This do X when Y-ing doesn't work: the choosing is something I do
today, but the sending is something the software does tomorrow.  And
besides, I routinely leave the frontend set to pager but disable
mailing. 

I had All frontends but 'none' can also mail a copy - would the
version below be more acceptable?

   This setting can be overridden at execution time. By default, all the
   frontends except for 'none' will also send copies by mail.

Or if frontends is too technical, we could safely switch it to
options here. 

 Template: apt-listchanges/confirm
[...]
  After displaying the list of changes, apt-listchanges can pause with
  a confirmation prompt. This is useful when running from APT, as it
  offers an opportunity to abort the upgrade if a change is unwelcome.

Yes, can pause here is an improvement on may pause.

  This setting does not apply to the 'mail' or 'none' settings, and can be
  overridden at execution time.

The LCFC had the 'mail' or 'none' frontends; if frontends is a
problem we should find a better word to use throughout.  This double
use of the word setting strikes me as confusing.  What do people
think of something like:

   This can be overridden at execution time, and has no effect if
   the configured frontend option is 'mail' or 'none'.
-- 
JBR with qualifications in linguistics, experience as a Debian
sysadmin, and probably no clue about this particular package



-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]



Bug#455772: apt-listchanges: [debconf_rewrite] Debconf templates and debian/control review

2007-12-11 Thread Christian Perrier
Package: apt-listchanges
Version: N/A
Severity: normal
Tags: patch

Dear Debian maintainer,

On Monday, November 26, 2007, I notified you of the beginning of a review 
process
concerning debconf templates for apt-listchanges.

The debian-l10n-english contributors have now reviewed these templates,
and the proposed changes are attached to this bug report.

Please review the suggested changes are suggested, and if you have any
objections, let me know in the next 3 days.

Please try to avoid uploading apt-listchanges with these changes right now.

The second phase of this process will begin on Saturday, December 15, 2007, 
when I will
coordinate updates to translations of debconf templates.

The existing translators will be notified of the changes: they will
receive an updated PO file for their language.

Simultaneously, a general call for new translations will be sent to
the debian-i18n mailing list.

Both these calls for translations will request updates to be sent as
individual bug reports. That will probably trigger a lot of bug
reports against your package, but these should be easier to deal with.

The call for translation updates and new translations will run until
about Saturday, January 05, 2008. Please avoid uploading a package with fixed 
or changed
debconf templates and/or translation updates in the meantime. Of
course, other changes are safe.

Please note that this is an approximative delay, which depends on my
own availability to process this work and is influenced by the fact
that I simultaneously work on many packages.

Around Sunday, January 06, 2008, I will contact you again and will send a final 
patch
summarizing all the updates (changes to debconf templates,
updates to debconf translations and new debconf translations).

Again, thanks for your attention and cooperation.


-- System Information:
Debian Release: lenny/sid
  APT prefers unstable
  APT policy: (500, 'unstable'), (1, 'experimental')
Architecture: i386 (i686)

Kernel: Linux 2.6.22-3-686 (SMP w/1 CPU core)
Locale: LANG=C, LC_CTYPE=C (charmap=ANSI_X3.4-1968)
Shell: /bin/sh linked to /bin/dash
--- apt-listchanges.old/debian/templates2007-11-24 13:41:54.270251200 
+0530
+++ apt-listchanges/debian/templates2007-12-12 00:34:59.563590686 +0530
@@ -1,62 +1,67 @@
+# These templates have been reviewed by the debian-l10n-english
+# team
+#
+# If modifications/additions/rewording are needed, please ask
+# [EMAIL PROTECTED] for advice.
+#
+# Even minor modifications require translation updates and such
+# changes should be coordinated with translators and reviewers.
+
 Template: apt-listchanges/frontend
 Type: select
-__Choices: pager, gtk, browser, xterm-pager, xterm-browser, text, mail, none
+__Choices: pager, browser, xterm-pager, xterm-browser, gtk, text, mail, none
 Default: pager
 _Description: Method for changes display:
- apt-listchanges can display package changes in a number of different
- ways.
+ Package changes may be displayed by apt-listchanges
+ in a number of different ways.
  .
-  pager : use your preferred pager to display changes one page at
-  a time;
-  gtk   : Display changes in a Gtk window;
-  browser   : display HTML-formatted changes using a web browser;
-  xterm-pager   : like pager, but in an xterm in the background;
-  xterm-browser : like browser, but in an xterm in the background;
-  text  : print changes to your terminal (without pausing);
-  mail  : only send changes via mail;
-  none  : do not run automatically from apt.
+  pager: display changes one page at a time;
+  browser  : display HTML-formatted changes using a web browser;
+  xterm-pager  : like pager, but in an xterm in the background;
+  xterm-browser: like browser, but in an xterm in the background;
+  gtk  : display changes in a GTK window;
+  text : print changes to the terminal (without pausing);
+  mail : only send changes via mail;
+  none : do not run automatically from APT.
  .
- This setting can be overridden by a command-line option or an environment
- variable.  Note that you can still send a copy via mail with all of the
- frontends except 'none'.
+ This setting can be overridden at execution time. All frontends but
+ 'none' can also mail a copy.
 
 Template: apt-listchanges/email-address
 Type: string
 Default: root
-_Description: E-mail Address(es) which will receive changes:
- apt-listchanges can email a copy of displayed changes.  Please enter
- the email address the changes should be sent to.
+_Description: E-mail address(es) which will receive changes:
+ Optionally, apt-listchanges can e-mail a copy of displayed changes to
+ a specified address.
  .
- Multiple addresses may be specified, delimited by commas.  Leave this
- empty if you do not want any email to be sent.
+ Multiple addresses may be specified, delimited by commas. Leaving this
+ field empty disables mail notifications.
 
 Template: 

Bug#455772: apt-listchanges: [debconf_rewrite] Debconf templates and debian/control review

2007-12-11 Thread Pierre Habouzit
On Tue, Dec 11, 2007 at 07:05:04PM +, Christian Perrier wrote:
 Package: apt-listchanges
 Version: N/A
 Severity: normal
 Tags: patch
 
 Dear Debian maintainer,
 
 On Monday, November 26, 2007, I notified you of the beginning of a review 
 process
 concerning debconf templates for apt-listchanges.
 
 The debian-l10n-english contributors have now reviewed these templates,
 and the proposed changes are attached to this bug report.
 
 Please review the suggested changes are suggested, and if you have any
 objections, let me know in the next 3 days.

  I don't care, you can start the process right now instead of the 15th,
I trust you for the changes, I'm sure those will be better than what I
can write in english anyways.

 The second phase of this process will begin on Saturday, December 15, 2007, 
 when I will
 coordinate updates to translations of debconf templates.

  you can make that be now if that helps.


-- 
·O·  Pierre Habouzit
··O[EMAIL PROTECTED]
OOOhttp://www.madism.org


pgpt3IeHY7W7V.pgp
Description: PGP signature


Bug#455772: apt-listchanges: [debconf_rewrite] Debconf templates and debian/control review

2007-12-11 Thread Christian Perrier
Quoting Pierre Habouzit ([EMAIL PROTECTED]):

   I don't care, you can start the process right now instead of the 15th,
 I trust you for the changes, I'm sure those will be better than what I
 can write in english anyways.

OK, launching the process immediately, then. Indeed the small delay is
meant to allow a final discussion, in case the maintainer disagrees
with a changeand also allows maintainers that are less responsive
than you to still be able to react.

But I knew that Pierre SpeedCoder would react at the speed of light,
of course...:-)




signature.asc
Description: Digital signature