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

[RFR] templates://astk/{astk.templates}



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

This review will last from Saturday, May 22, 2010 to Tuesday, June 01, 2010.

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:
--- astk.old/debian/astk.templates	2010-05-14 18:59:41.431052913 +0200
+++ astk/debian/astk.templates	2010-05-18 07:41:49.804782080 +0200
@@ -7,20 +7,19 @@
 
 Template: astk/domainname
 _Type: string
-_Description: astk server domain name:
-  This is the domain your astk server is a member of. Typically it is
-  something like "mycompany.com" or "myuniversity.edu".
+_Description: Domain name for the astk server:
+ Please enter the domain name which this astk server should be a member of.

Avoid leading lowercase.

Avoid "This is" that creates a link between the synopsis and the long
description.

Avoid non-existing domains as example. I actually don't think it is
really needed to give an example. If we really need to, then use "example.org".
 
 Template: astk/servername
 Type: string
-_Description: astk server unqualified hostname:
- Please enter the server hostname without domain name.
+_Description: Host name for the astk server:
+ Please enter the server host name without domain name.

About the same rationale.

 
 Template: astk/node
 Type: string
-_Description: hostname:
- This is the name by which this computer will be known on the network. It
- has to be a unique name in your domain.
+_Description: Published host name:
+ Please enter the name by which this server will be known on the network. It
+ has to be a unique name in the domain.

And again.....
 
 Template: astk/EDITOR
 Type: select
@@ -33,20 +32,21 @@
 Type: select
 Choices: /usr/bin/xterm -display @D -e @E, /usr/bin/gnome-terminal --display=@D --command=@E, /usr/bin/konsole --display @D -e @E
 Default: /usr/bin/gnome-terminal --display=@D --command=@E
-_Description: favorite Terminal: 
- Please select the terminal to be used.
+_Description: Command line for launching a terminal window:
+ Please choose the command line that should be used when launching a
+ terminal window is requested.

Uncapitalize "Terminal". I assume that what is asked here is what I
wrote: "which command line should be used to open a terminal window.
 
 Template: astk/MPIRUN
 Type: select
 Choices: LAM, OPENMPI, MPICH2
 Default: OPENMPI
 _Description: MPI implementation: 
- Please select the MPI implementation to be used.
+ Please select the MPI implementation to be used in this astk server.


"to be used in what"?
 
 Template: astk/IFDEF
 Type: select
 Choices: LINUX, LINUX64
 Default: LINUX64
-_Description: "aster" platform.
+_Description: Platform running "aster":
  Please select the platform running aster.
  
Hopefully people know what "aster" is. I still fear we need to be more
precise in case this package is installed along with dozens of other
packages.


--- astk.old/debian/control	2010-05-14 18:59:41.435093043 +0200
+++ astk/debian/control	2010-05-18 07:42:38.249779527 +0200
@@ -16,11 +16,11 @@
 Depends: tk8.5 | wish, tcl8.5 | tclsh, debconf (>= 1.5.30), ${misc:Depends}
 Recommends: astk-server
 Suggests: eficas, gmsh, grace, nedit, ddd
-Description: Code_Aster build/control system and front-end: Tcl client
+Description: Code_Aster build/control system and front-end - Tcl client
  ASTK includes the Python build and control systems and Tcl front end for the
  Code_Aster finite element PDE solver.
  .
- This package contains the ASTK Tcl front-end client.  If you want to run
+ This package contains the ASTK Tcl front-end client. If you want to run
  astk/aster on the local host, you need to install python-astk-server as well.

I haven't been very invasive here.

Just use our standard recommended form for thesynopsis and drop double spaces.

 
 Package: astk-server
@@ -28,7 +28,7 @@
 Section: python
 Depends: ${python:Depends}, python-numpy, debconf (>= 1.5.30), ${misc:Depends}
 Suggests: emacs, gdb, ddd
-Description: Code_Aster build/control system and front-end: Python server
+Description: Code_Aster build/control system and front-end - Python server
  ASTK includes the Python build and control systems and Tcl front end for the
  Code_Aster finite element PDE solver.
  .

Ditto

-- 


Template: astk/platform
Type: select
Choices: LINUX, P_LINUX, LINUX64, P_LINUX64
Default: LINUX64
_Description: aster platform:
  Select aster platform.

Template: astk/domainname
_Type: string
_Description: Domain name for the astk server:
 Please enter the domain name which this astk server should be a member of.

Template: astk/servername
Type: string
_Description: Host name for the astk server:
 Please enter the server host name without domain name.

Template: astk/node
Type: string
_Description: Published host name:
 Please enter the name by which this server will be known on the network. It
 has to be a unique name in the domain.

Template: astk/EDITOR
Type: select
Choices: nedit, gedit --display=@D, kwrite --display @D, xemacs -display @D, emacs -display @D, xedit -display @D, xterm  -display @D -e @E -e vi
Default: nedit
_Description: favorite Editor.
 Please select the editor to be used.

Template: astk/TERMINAL
Type: select
Choices: /usr/bin/xterm -display @D -e @E, /usr/bin/gnome-terminal --display=@D --command=@E, /usr/bin/konsole --display @D -e @E
Default: /usr/bin/gnome-terminal --display=@D --command=@E
_Description: Command line for launching a terminal window:
 Please choose the command line that should be used when launching a
 terminal window is requested.

Template: astk/MPIRUN
Type: select
Choices: LAM, OPENMPI, MPICH2
Default: OPENMPI
_Description: MPI implementation: 
 Please select the MPI implementation to be used in this astk server.

Template: astk/IFDEF
Type: select
Choices: LINUX, LINUX64
Default: LINUX64
_Description: Platform running "aster":
 Please select the platform running aster.
 
--- astk.old/debian/astk.templates	2010-05-14 18:59:41.431052913 +0200
+++ astk/debian/astk.templates	2010-05-22 07:58:51.126524460 +0200
@@ -7,20 +7,19 @@
 
 Template: astk/domainname
 _Type: string
-_Description: astk server domain name:
-  This is the domain your astk server is a member of. Typically it is
-  something like "mycompany.com" or "myuniversity.edu".
+_Description: Domain name for the astk server:
+ Please enter the domain name which this astk server should be a member of.
 
 Template: astk/servername
 Type: string
-_Description: astk server unqualified hostname:
- Please enter the server hostname without domain name.
+_Description: Host name for the astk server:
+ Please enter the server host name without domain name.
 
 Template: astk/node
 Type: string
-_Description: hostname:
- This is the name by which this computer will be known on the network. It
- has to be a unique name in your domain.
+_Description: Published host name:
+ Please enter the name by which this server will be known on the network. It
+ has to be a unique name in the domain.
 
 Template: astk/EDITOR
 Type: select
@@ -33,20 +32,21 @@
 Type: select
 Choices: /usr/bin/xterm -display @D -e @E, /usr/bin/gnome-terminal --display=@D --command=@E, /usr/bin/konsole --display @D -e @E
 Default: /usr/bin/gnome-terminal --display=@D --command=@E
-_Description: favorite Terminal: 
- Please select the terminal to be used.
+_Description: Command line for launching a terminal window:
+ Please choose the command line that should be used when launching a
+ terminal window is requested.
 
 Template: astk/MPIRUN
 Type: select
 Choices: LAM, OPENMPI, MPICH2
 Default: OPENMPI
 _Description: MPI implementation: 
- Please select the MPI implementation to be used.
+ Please select the MPI implementation to be used in this astk server.
 
 Template: astk/IFDEF
 Type: select
 Choices: LINUX, LINUX64
 Default: LINUX64
-_Description: "aster" platform.
+_Description: Platform running "aster":
  Please select the platform running aster.
  
--- astk.old/debian/control	2010-05-14 18:59:41.435093043 +0200
+++ astk/debian/control	2010-05-18 07:42:38.249779527 +0200
@@ -16,11 +16,11 @@
 Depends: tk8.5 | wish, tcl8.5 | tclsh, debconf (>= 1.5.30), ${misc:Depends}
 Recommends: astk-server
 Suggests: eficas, gmsh, grace, nedit, ddd
-Description: Code_Aster build/control system and front-end: Tcl client
+Description: Code_Aster build/control system and front-end - Tcl client
  ASTK includes the Python build and control systems and Tcl front end for the
  Code_Aster finite element PDE solver.
  .
- This package contains the ASTK Tcl front-end client.  If you want to run
+ This package contains the ASTK Tcl front-end client. If you want to run
  astk/aster on the local host, you need to install python-astk-server as well.
 
 Package: astk-server
@@ -28,7 +28,7 @@
 Section: python
 Depends: ${python:Depends}, python-numpy, debconf (>= 1.5.30), ${misc:Depends}
 Suggests: emacs, gdb, ddd
-Description: Code_Aster build/control system and front-end: Python server
+Description: Code_Aster build/control system and front-end - Python server
  ASTK includes the Python build and control systems and Tcl front end for the
  Code_Aster finite element PDE solver.
  .
Source: astk
Section: science
Priority: extra
Maintainer: Debian Science Team <debian-science-maintainers@lists.alioth.debian.org>
Uploaders: Christophe Trophime <christophe.trophime@grenoble.cnrs.fr>, "Adam C. Powell, IV" <hazelsct@debian.org>
Standards-Version: 3.8.4
Build-Depends: debhelper (>= 7), cdbs (>= 0.4.49), quilt, python-all (>= 2.5.4-9), python-support (>= 1.0.7), po-debconf
Homepage: http://www.code-aster.org/
Vcs-Svn: svn://svn.debian.org/svn/debian-science/packages/code-aster/astk/
Vcs-Browser: http://svn.debian.org/viewsvn/debian-science/packages/code-aster/astk/


Package: astk
Architecture: all
Section: science
Depends: tk8.5 | wish, tcl8.5 | tclsh, debconf (>= 1.5.30), ${misc:Depends}
Recommends: astk-server
Suggests: eficas, gmsh, grace, nedit, ddd
Description: Code_Aster build/control system and front-end - Tcl client
 ASTK includes the Python build and control systems and Tcl front end for the
 Code_Aster finite element PDE solver.
 .
 This package contains the ASTK Tcl front-end client. If you want to run
 astk/aster on the local host, you need to install python-astk-server as well.

Package: astk-server
Architecture: all
Section: python
Depends: ${python:Depends}, python-numpy, debconf (>= 1.5.30), ${misc:Depends}
Suggests: emacs, gdb, ddd
Description: Code_Aster build/control system and front-end - Python server
 ASTK includes the Python build and control systems and Tcl front end for the
 Code_Aster finite element PDE solver.
 .
 This package contains the astk server which runs aster.

Attachment: signature.asc
Description: Digital signature


Reply to: