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

[RFR] templates://tex-common/{templates}



Please find, for review, the debconf templates and packages descriptions for the tex-common source package.

This review will last from Tuesday, October 09, 2007 to Friday, October 19, 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:

--- ../tex-common.old/debian/templates	2007-10-06 19:13:52.503159869 +0200
+++ debian/templates	2007-10-09 07:02:00.242183060 +0200
@@ -5,22 +5,23 @@
  .
  No setting of ${variable}.
  .
- TeX will not work without it, you need to fix your configuration
- files.  The version of ${filename} that is provided by the package
+ TeX will not work without it and configuration files must be
+ fixed. The version of ${filename} that is provided by the package
  should be available as ${filename}.ucf-dist.

We avoid "personnalisation" (files are not owned by the local system
admin) and therefore I propose a more neutral wording.

We also try to standardise against the use of double spaces after
sentence dots which leads to numerous inconsistencies in English texts.
  .
- Exiting.
+ The configuration process is aborted.

"Exiting." is a little bit "short". Hence the propsoed rewrite.

 
 Template: tex-common/check_texmf_wrong
 Type: error
-_Description: Essential entry wrong in ${filename}
- An essential entry is wrong in ${filename}:
- ${variable} does not contain
+#flag:translate!:3
+_Description: Invalid essential entry in ${filename}
+ An essential entry is invalid in ${filename}:
+ ${variable} does not contain:

Avoids having a line with only a variable to be proposed for
translation. Minimizes translator's errors.

"wrong" is too much "spoken language".

  .
  ${pattern}
  .
- TeX will not work without it, you need to fix your configuration
- files.  The version of ${filename} that is provided by the package
+ TeX will not work without it and configuration files must be
+ fixed. The version of ${filename} that is provided by the package
  should be available as ${filename}.ucf-dist.
  .
- Exiting.
+ The configuration process is aborted.

Same than above.

--- ../tex-common.old/debian/control	2007-10-06 19:13:52.503159869 +0200
+++ debian/control	2007-10-09 07:02:36.740483932 +0200
@@ -13,12 +13,12 @@
 Suggests: debhelper (>= 4.0)
 Replaces: tetex-base (<= 3.0-10)
 Conflicts: tetex-bin (<= 3.0-4), tetex-base (<= 3.0-3)
-Description: Common infrastructure for using and building TeX in Debian
+Description: common infrastructure for using and building TeX

Avoid initial capital (see DevRef for advices about writing packages descriptions)

Avoid "branding" with 'Debian' which brings headaches to derived distributions.
I think the description is still accurate without it.


  This package contains a number of scripts and common configuration
  files that are needed to install a TeX System, either teTeX or
  TeX-Live.
  .
  It also contains some files used when creating tetex packages from
- the Debian source packages, and which allow a synchronisation between
+ the source packages, and which allow a synchronization between

Unbranding, again.

We converged on US-style spelling

  the two source packages of teTeX (tetex-base and tetex-bin) and
  tex-live. 

-- 


Template: tex-common/check_texmf_missing
Type: error
_Description: Essential entry missing in ${filename}
 An essential entry is missing in ${filename}:
 .
 No setting of ${variable}.
 .
 TeX will not work without it and configuration files must be
 fixed. The version of ${filename} that is provided by the package
 should be available as ${filename}.ucf-dist.
 .
 The configuration process is aborted.

Template: tex-common/check_texmf_wrong
Type: error
#flag:translate!:3
_Description: Invalid essential entry in ${filename}
 An essential entry is invalid in ${filename}:
 ${variable} does not contain:
 .
 ${pattern}
 .
 TeX will not work without it and configuration files must be
 fixed. The version of ${filename} that is provided by the package
 should be available as ${filename}.ucf-dist.
 .
 The configuration process is aborted.
--- ../tex-common.old/debian/templates	2007-10-06 19:13:52.503159869 +0200
+++ debian/templates	2007-10-09 07:02:00.242183060 +0200
@@ -5,22 +5,23 @@
  .
  No setting of ${variable}.
  .
- TeX will not work without it, you need to fix your configuration
- files.  The version of ${filename} that is provided by the package
+ TeX will not work without it and configuration files must be
+ fixed. The version of ${filename} that is provided by the package
  should be available as ${filename}.ucf-dist.
  .
- Exiting.
+ The configuration process is aborted.
 
 Template: tex-common/check_texmf_wrong
 Type: error
-_Description: Essential entry wrong in ${filename}
- An essential entry is wrong in ${filename}:
- ${variable} does not contain
+#flag:translate!:3
+_Description: Invalid essential entry in ${filename}
+ An essential entry is invalid in ${filename}:
+ ${variable} does not contain:
  .
  ${pattern}
  .
- TeX will not work without it, you need to fix your configuration
- files.  The version of ${filename} that is provided by the package
+ TeX will not work without it and configuration files must be
+ fixed. The version of ${filename} that is provided by the package
  should be available as ${filename}.ucf-dist.
  .
- Exiting.
+ The configuration process is aborted.
--- ../tex-common.old/debian/control	2007-10-06 19:13:52.503159869 +0200
+++ debian/control	2007-10-09 07:02:36.740483932 +0200
@@ -13,12 +13,12 @@
 Suggests: debhelper (>= 4.0)
 Replaces: tetex-base (<= 3.0-10)
 Conflicts: tetex-bin (<= 3.0-4), tetex-base (<= 3.0-3)
-Description: Common infrastructure for using and building TeX in Debian
+Description: common infrastructure for using and building TeX
  This package contains a number of scripts and common configuration
  files that are needed to install a TeX System, either teTeX or
  TeX-Live.
  .
  It also contains some files used when creating tetex packages from
- the Debian source packages, and which allow a synchronisation between
+ the source packages, and which allow a synchronisation between
  the two source packages of teTeX (tetex-base and tetex-bin) and
  tex-live. 
Source: tex-common
Section: tex
Priority: optional
Maintainer: Debian TeX maintainers <debian-tex-maint@lists.debian.org>
Uploaders: Julian Gilbey <jdg@debian.org>, C.M. Connelly <cmc@debian.org>, Atsuhito KOHDA <kohda@debian.org>, Frank Küster <frank@debian.org>, Florent Rougon <frn@debian.org>, Norbert Preining <preining@debian.org>
Build-Depends: debhelper (>= 4.0.0), po-debconf
Build-Depends-Indep: debiandoc-sgml, eperl
Standards-Version: 3.7.2.0

Package: tex-common
Architecture: all
Depends: ucf, debconf (>= 1.4.69) | cdebconf (>= 0.39)
Suggests: debhelper (>= 4.0)
Replaces: tetex-base (<= 3.0-10)
Conflicts: tetex-bin (<= 3.0-4), tetex-base (<= 3.0-3)
Description: common infrastructure for using and building TeX
 This package contains a number of scripts and common configuration
 files that are needed to install a TeX System, either teTeX or
 TeX-Live.
 .
 It also contains some files used when creating tetex packages from
 the source packages, and which allow a synchronization between
 the two source packages of teTeX (tetex-base and tetex-bin) and
 tex-live. 

Attachment: signature.asc
Description: Digital signature


Reply to: