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

Re: Bug#747697: [LCFC] templates://debian-security-support/{debian-security-support.templates}



Thijs Kinkhorst wrote:
> On Wed, May 28, 2014 06:39, Christian PERRIER wrote:
>> This is the last call for comments for the review of debconf
>> templates for debian-security-support.
> 
> From debian/control:
> 
> "for which support has had to be limited"
> 
> The form 'has had to be' seems contructed to me and also general writing
> advice advises against using the passive form. Can we reword that to
> something simpler and active, like "for which Debian had to limit security
> support"?

That goes back to the usage error we had before: the problem isn't
that once a long time ago Debian _needed_ to do this, it's that Debian
_has_ needed to do this (present perfect implying ongoing relevance).
Elsewhere we've avoided the pile-up of forms of the verb "have" by
saying "it has been necessary to", and we might as well do the same
here.

This also happens to replace the passive form with an impersonal form,
which isn't really any better but avoids setting off grammar-checkers.

> The two Debconf templates miss a bit of "what now?" information, in my
> opinion. Especially the "/limited" one: as an admin, I get the message
> that one of my packages is now in 'limited' support, where can I find out
> what that means?

For responsible admins all of the information in these templates will
in theory already have passed through their heads once when they read
the corresponding security-announce posting; this is just a reminder
(helping with the often annoyingly difficult step of connecting
source-package and binary-package names).  But I agree it would be
nice if there was some URL we could point at for general background.
-- 
JBR	with qualifications in linguistics, experience as a Debian
	sysadmin, and probably no clue about this particular package
diff -ru debian-security-support-2014.05.27.pristine/debian/control debian-security-support-2014.05.27/debian/control
--- debian-security-support-2014.05.27.pristine/debian/control	2014-05-16 20:10:28.000000000 +0100
+++ debian-security-support-2014.05.27/debian/control	2014-05-28 10:02:54.988110707 +0100
@@ -17,11 +17,14 @@
 Depends: ${misc:Depends},
     adduser,
     gettext-base,
-Description: Identify installed packages with ended/limited security support
- For some Debian packages, maintaining security support is not
- feasible for the planned life cycle. For other packages, security
- support is limited, it does not cover the full feature set.
+Description: Debian security support coverage checker
+ For some Debian packages, it is not feasible to maintain full security
+ support for all use cases through the full distribution release
+ cycle.
  .
- This package provides a program to identify installed packages
- where support had to be ended prematurely or is limited, and alerts
- the administrator in that case.
+ This package provides a program to identify installed packages for
+ which it has been necessary to limit or prematurely end support, and to
+ alert the administrator.
+ .
+ New versions of this package with updated checklists are provided
+ via security updates.
diff -ru debian-security-support-2014.05.27.pristine/debian/debian-security-support.templates debian-security-support-2014.05.27/debian/debian-security-support.templates
--- debian-security-support-2014.05.27.pristine/debian/debian-security-support.templates	2014-04-06 18:57:13.000000000 +0100
+++ debian-security-support-2014.05.27/debian/debian-security-support.templates	2014-05-28 09:58:47.199175395 +0100
@@ -1,18 +1,21 @@
 Template: debian-security-support/ended
 Type: text
-_Description: Security support has ended for one or more packages
- Unfortunately, security support for some packages needed to be stopped
- before the end of the regular security maintenance life cycle.
+#flag:translate!:4
+_Description: Ended security support for one or more packages
+ Unfortunately, it has been necessary to end security support for some
+ packages before the end of the regular security maintenance life cycle.
  .
- The following packages found on your system are affected by this.
+ The following packages found on this system are affected by this:
  .
  ${MESSAGE}
 
 Template: debian-security-support/limited
 Type: text
-_Description: Security support is limited for one or more packages
- Unfortunately, security support for some packages had to be limited.
+#flag:translate!:4
+_Description: Limited security support for one or more packages
+ Unfortunately, it has been necessary to limit security support for some
+ packages.
  .
- The following packages found on your system are affected by this.
+ The following packages found on this system are affected by this:
  .
  ${MESSAGE}
Template: debian-security-support/ended
Type: text
#flag:translate!:4
_Description: Ended security support for one or more packages
 Unfortunately, it has been necessary to end security support for some
 packages before the end of the regular security maintenance life cycle.
 .
 The following packages found on this system are affected by this:
 .
 ${MESSAGE}

Template: debian-security-support/limited
Type: text
#flag:translate!:4
_Description: Limited security support for one or more packages
 Unfortunately, it has been necessary to limit security support for some
 packages.
 .
 The following packages found on this system are affected by this:
 .
 ${MESSAGE}
Source: debian-security-support
Section: admin
Priority: optional
Maintainer: Christoph Biedl <debian.axhn@manchmal.in-ulm.de>
Uploaders: Debian Security Team <team@security.debian.org>
Build-Depends: debhelper (>= 8~),
    asciidoc,
    gettext,
    libfile-slurp-perl,
    libtest-command-perl,
    libtest-differences-perl,
    xmlto,
Standards-Version: 3.9.5

Package: debian-security-support
Architecture: all
Depends: ${misc:Depends},
    adduser,
    gettext-base,
Description: Debian security support coverage checker
 For some Debian packages, it is not feasible to maintain full security
 support for all use cases through the full distribution release
 cycle.
 .
 This package provides a program to identify installed packages for
 which it has been necessary to limit or prematurely end support, and to
 alert the administrator.
 .
 New versions of this package with updated checklists are provided
 via security updates.

Reply to: