[cl-debian] [RFR] templates://gcl/{in.gcl.templates}

Christian Perrier bubulle at debian.org
Wed Dec 5 04:03:40 UTC 2007


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

This review will last from Wednesday, December 05, 2007 to Saturday, December 15, 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:
--- ../gcl.old/debian/in.gcl.templates	2007-11-25 16:48:30.704811977 +0530
+++ debian/in.gcl.templates	2007-11-30 22:54:40.633726027 +0530
@@ -1,26 +1,30 @@
 Template: gcl at 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?

Capitalize the acronym

  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 at 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 at EXT@'.
+ .

Split in paragraph for btter readability. Use the "Choosing this
option" wording which we standardize over packages.

+ 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 at 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 at EXT@. The
+ currently enforced build flavor will be reported in the initial startup
  banner.

Re-split in another paragraph.
 
 Template: gcl at 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 has optional support for profiling via gprof.

Avoid the "now has".....that implies a time reference while the
templates might be there for ages.

+ .
+ 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.
+ .
+ Profiling support may be enforced by filling the
+ GCL_PROF environment variable with any non-empty string for profiling
+ support. More optimized builds are possible by setting an empty string for the more optimized builds, e.g.
  GCL_PROF=t gcl at EXT@.  If profiling is enabled, this will be reported in
  the initial startup banner.

Again, split in paragraphs.

--- ../gcl.old/debian/control	2007-11-25 16:48:30.704811977 +0530
+++ debian/control	2007-11-30 23:07:33.125839118 +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

Use the standard "common description - specific description" style
over the binary packages

  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
+ forth in the book "Common Lisp, the Language I". It attempts

Avoid double spaces.


  to strike a useful middle ground in performance and portability
  from its design around C.
  .
- This package contains the Lisp system itself.  Documentation 
+ This package contains the Lisp system itself. The documentation 

Ditto.

  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
+ 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.
  .
- 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.

Minor reword (better?). Uncapitalize "documentation".


-- 


-------------- next part --------------
Template: gcl at EXT@/default_gcl_ansi
Type: boolean
_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.
 Choosing this option will determine which image will be used by default
 when executing 'gcl at 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 at EXT@. The
 currently enforced build flavor will be reported in the initial startup
 banner.

Template: gcl at EXT@/default_gcl_prof
Type: boolean
_Description: Use the profiling build by default?
 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.
 .
 Profiling support may be enforced by filling the
 GCL_PROF environment variable with any non-empty string for profiling
 support. More optimized builds are possible by setting an empty string for the more optimized builds, e.g.
 GCL_PROF=t gcl at EXT@.  If profiling is enabled, this will be reported in
 the initial startup banner.
-------------- next part --------------
--- gcl.old/debian/in.gcl.templates	2007-11-25 16:48:30.704811977 +0530
+++ gcl/debian/in.gcl.templates	2007-11-30 22:54:40.633726027 +0530
@@ -1,26 +1,30 @@
 Template: gcl at 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 at 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 at 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 at 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 at EXT@. The
+ currently enforced build flavor will be reported in the initial startup
  banner.
 
 Template: gcl at 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 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.
+ .
+ Profiling support may be enforced by filling the
+ GCL_PROF environment variable with any non-empty string for profiling
+ support. More optimized builds are possible by setting an empty string for the more optimized builds, e.g.
  GCL_PROF=t gcl at 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-05 09:33:13.377079980 +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
+ 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.
  .
- 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
+ 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.
  .
- 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.
-------------- next part --------------
Source: gcl
Section: interpreters
Priority: optional
Maintainer: Camm Maguire <camm at enhanced.com>
Build-Depends: debhelper (>= 4.1.16), libreadline5-dev | libreadline-dev, m4, tk8.4-dev, texlive-latex-base, texinfo, libgmp3-dev, autotools-dev, libxmu-dev, libxaw7-dev, po-debconf
Standards-Version: 3.7.2

Package: gcl
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}, ${gcc}, debconf (>= 1.2.0), emacs22 | emacsen
Suggests: gcl-doc
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.
 .
 This package contains the Lisp system itself. The documentation 
 is provided in the gcl-doc package.

Package: gcl-doc
Section: doc
Architecture: all
Conflicts: gclinfo
Replaces: gclinfo
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.
 .
 This package contains the GCL documentation in info format for the
 system internals as well as the graphical interface currently
 implemented in Tcl/Tk.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 189 bytes
Desc: Digital signature
URL: <https://mailman.common-lisp.net/pipermail/cl-debian/attachments/20071205/0f145e9a/attachment.sig>


More information about the Cl-debian mailing list