Subject: gcl: [debconf_rewrite] Debconf templates and debian/control review
From: Christian Perrier <[email-masked]>
To: Debian Bug Tracking System <[email-masked]>
Date: Wed, 19 Dec 2007 11:56:10 +0530

Package: gcl
Version: N/A
Severity: normal
Tags: patch

Dear Debian maintainer,

On Friday, November 30, 2007, I notified you of the beginning of a review process
concerning debconf templates for gcl.

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 gcl with these changes right now.

The second phase of this process will begin on Saturday, December 22, 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 12, 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 13, 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
--- gcl.old/debian/in.gcl.templates	2007-11-25 16:48:30.704811977 +0530
+++ gcl/debian/in.gcl.templates	2007-12-19 11:56:03.350211134 +0530
@@ -1,26 +1,38 @@
+# These templates have been reviewed by the debian-l10n-english
+# team
+#
+# If modifications/additions/rewording are needed, please ask
+# [email-masked] for advice.
+#
+# Even minor modifications require translation updates and such
+# changes should be coordinated with translators and reviewers.
+
 Template: gcl@EXT@/default_gcl_ansi
 Type: boolean
-_Description: Use the work-in-progress ansi build by default?
+_Description: Use the work-in-progress ANSI build by default?
  GCL is in the process of providing an ANSI compliant image in addition to
- its traditional CLtL1 image still in production use.  Please see the
- README.Debian file for a brief description of these terms.  Setting this
- variable will determine which image you will use by default on executing
- 'gcl@EXT@'.  You can locally override this choice by setting the GCL_ANSI
+ its traditional CLtL1 image still in production use.
+ .
+ Please see the README.Debian file for a brief description of these terms.
+ Choosing this option will determine which image will be used by default
+ when executing 'gcl@EXT@'.
+ .
+ This setting may be overridden by setting the GCL_ANSI
  environment variable to any non-empty string for the ANSI build, and to
- the empty string for the CLtL1 build, e.g. GCL_ANSI=t gcl@EXT@.  The
- flavor of the build in force will be reported in the initial startup
+ the empty string for the CLtL1 build, e.g. GCL_ANSI=t gcl@EXT@. The
+ currently enforced build flavor will be reported in the initial startup
  banner.
 
 Template: gcl@EXT@/default_gcl_prof
 Type: boolean
 _Description: Use the profiling build by default?
- GCL now has optional support for profiling via gprof.  Please see the
- documentation
- for si::gprof-start and si::gprof-quit for details. As this build is slower
- than builds without gprof support, it is not recommended for final production use.
- You can locally override the default choice made here
- by setting the
- GCL_PROF environment variable to any non-empty string for profiling
- support, and to the empty string for the more optimized builds, e.g.
- GCL_PROF=t gcl@EXT@.  If profiling is enabled, this will be reported in
- the initial startup banner.
+ GCL has optional support for profiling via gprof.
+ .
+ Please see the documentation for si::gprof-start and si::gprof-quit
+ for details. As this build is slower than builds without gprof
+ support, it is not recommended for final production use.
+ .
+ Set the GCL_PROF environment variable to the empty string for more
+ optimized builds, or any non-empty string for profiling support; e.g.
+ GCL_PROF=t gcl@EXT@. If profiling is enabled, this will be reported
+ in the initial startup banner.
--- gcl.old/debian/control	2007-11-25 16:48:30.704811977 +0530
+++ gcl/debian/control	2007-12-16 15:38:12.473983404 +0530
@@ -9,14 +9,14 @@
 Architecture: any
 Depends: ${shlibs:Depends}, ${misc:Depends}, ${gcc}, debconf (>= 1.2.0), emacs22 | emacsen
 Suggests: gcl-doc
-Description: GNU Common Lisp compiler
+Description: GNU Common Lisp compiler - binaries
  GNU Common Lisp (GCL) is a Common Lisp compiler and interpreter
- implemented in C, and complying mostly with the standard set 
- forth in the book "Common Lisp, the Language I".  It attempts
- to strike a useful middle ground in performance and portability
- from its design around C.
+ implemented in C, and complying mostly with the standard set forth in
+ the book "Common Lisp, the Language (1st edition)". It attempts to
+ take a useful middle ground in performance and portability by way of
+ its design around C.
  .
- This package contains the Lisp system itself.  Documentation 
+ This package contains the Lisp system itself. The documentation 
  is provided in the gcl-doc package.
 
 Package: gcl-doc
@@ -24,13 +24,13 @@
 Architecture: all
 Conflicts: gclinfo
 Replaces: gclinfo
-Description: Documentation for GNU Common Lisp
+Description: GNU Common Lisp compiler - documentation
  GNU Common Lisp (GCL) is a Common Lisp compiler and interpreter
- implemented in C, and complying mostly with the standard set 
- forth in the book "Common Lisp, the Language I".  It attempts
- to strike a useful middle ground in performance and portability
- from its design around C.
+ implemented in C, and complying mostly with the standard set forth in
+ the book "Common Lisp, the Language (1st edition)". It attempts to
+ take a useful middle ground in performance and portability by way of
+ its design around C.
  .
- This package contains Documentation in info format of both the
- system internals, as well as the graphical interface currently
+ This package contains the GCL documentation in info format for the
+ system internals as well as the graphical interface currently
  implemented in Tcl/Tk.