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@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@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@'. + . 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@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. Re-split in another paragraph. 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 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@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". --