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

Re: [RFR] templates://sinfo/{sinfo.templates}



On Wed, Oct 14, 2009 at 09:56:56PM +0300, Esko Arajärvi wrote:
> +_Description: Enable the sinfo CGI interface?
> + The sinfo package includes a CGI script web interface for sinfo. It is

CGI expands to Common Gateway Interface, so the second 'interface' is
unneccessary. To avoid repeating sinfo too may times in the sentence, you
might consider 'for your web server', which is where the installer will
put it if the answer is yes.

> + disabled by default as it might publish information the computer not
> + intended to be public.
                                                      ^^^^^^^^
Presumably the computer doesn't make this decision, the administrator does
(which is why we're asking the question). Inserting 'about' here is the
cleanest way to get around it.

So the template then reads:

   _Description: Enable the sinfo CGI script?
    The sinfo package includes a CGI for your web server. It is
    disabled by default as it might publish information about the computer not
    intended to be public.

> --- ../sinfo.old/debian/control	2009-10-10 21:47:53.000000000 +0300
> +++ debian/control	2009-10-14 21:05:07.000000000 +0300
> @@ -9,11 +9,11 @@
>  Architecture: any
>  Depends: debconf, ${shlibs:Depends}, ${misc:Depends}
>  Conflicts: slurm-llnl
> -Description: Monitoring tool for computer clusters using broadcasts
> +Description: tool for monitoring computer clusters using broadcasts
> 
> Clarify that it is this tool that uses the broadcasts.
> 
>   Sinfo is a monitoring tool that uses network broadcasts to distribute
> - information about the status of a cluster node on your local network. It
> + information about the status of cluster nodes on your local network. It
>   broadcasts CPU, memory usage, network load, and information about the top
>   5 processes of each computer. Sinfo consists of a daemon running on each
> - node to distribute the information and an ncurses frontend to monitor the
> + node distributing the information and an ncurses frontend to monitor the
>   nodes.

That's a big paragraph: I've split it at its natural break, and avoided
capitalising the package name:

    .
    The sinfo package includes a daemon running on each
    node distributing the information, and an ncurses frontend to monitor them.

Again, avoid repeating 'node' by calling the collection 'them'.


-- 
Jonathan Wiltshire

1024D: 0xDB800B52 / 4216 F01F DCA9 21AC F3D3  A903 CA6B EA3E DB80 0B52
4096R: 0xD3524C51 / 0A55 B7C5 1223 3942 86EC  74C3 5394 479D D352 4C51
--- /home/jona/debian/rewrite/sinfo/sinfo.old/debian/sinfo.templates	2009-10-14 20:05:16.000000000 +0100
+++ /home/jona/debian/rewrite/sinfo/sinfo/debian/sinfo.templates	2009-10-14 20:25:08.000000000 +0100
@@ -1,7 +1,7 @@
 Template: sinfo/cgi
 Type: boolean
 Default: false
-_Description: Enable the CGI interface to sinfo?
- Sinfo includes a CGI-script which provides a web-interface
- to sinfo. The CGI-script may publish information about
- your computer you don't want to make available to the public.
+_Description: Enable the sinfo CGI script?
+ The sinfo package includes a CGI for your web server. It is
+ disabled by default as it might publish information about the computer not
+ intended to be public.
--- /home/jona/debian/rewrite/sinfo/sinfo.old/debian/control	2009-10-14 20:05:16.000000000 +0100
+++ /home/jona/debian/rewrite/sinfo/sinfo/debian/control	2009-10-14 20:19:12.000000000 +0100
@@ -9,11 +9,12 @@
 Architecture: any
 Depends: debconf, ${shlibs:Depends}, ${misc:Depends}
 Conflicts: slurm-llnl
-Description: Monitoring tool for computer clusters using broadcasts
+Description: tool for monitoring computer clusters using broadcasts
  Sinfo is a monitoring tool that uses network broadcasts to distribute
- information about the status of a cluster node on your local network. It
+ information about the status of cluster nodes on your local network. It
  broadcasts CPU, memory usage, network load, and information about the top
- 5 processes of each computer. Sinfo consists of a daemon running on each
- node to distribute the information and an ncurses frontend to monitor the
- nodes.
+ 5 processes of each computer.
+ .
+ The sinfo package includes a daemon running on each
+ node distributing the information, and an ncurses frontend to monitor them.
 Homepage: http://www.ant.uni-bremen.de/whomes/rinas/sinfo/
Source: sinfo
Section: net
Priority: optional
Maintainer: Juergen Rinas <jrinas@gmx.de>
Build-Depends: debhelper (>= 7.0.0), libncurses5-dev, libboost-dev, libboost-signals-dev, libboost-regex-dev, libasio-dev, po-debconf
Standards-Version: 3.8.0.0

Package: sinfo
Architecture: any
Depends: debconf, ${shlibs:Depends}, ${misc:Depends}
Conflicts: slurm-llnl
Description: tool for monitoring computer clusters using broadcasts
 Sinfo is a monitoring tool that uses network broadcasts to distribute
 information about the status of cluster nodes on your local network. It
 broadcasts CPU, memory usage, network load, and information about the top
 5 processes of each computer.
 .
 The sinfo package includes a daemon running on each
 node distributing the information, and an ncurses frontend to monitor them.
Homepage: http://www.ant.uni-bremen.de/whomes/rinas/sinfo/
Template: sinfo/cgi
Type: boolean
Default: false
_Description: Enable the sinfo CGI script?
 The sinfo package includes a CGI for your web server. It is
 disabled by default as it might publish information about the computer not
 intended to be public.

Attachment: signature.asc
Description: Digital signature


Reply to: