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

Re: [RFR] templates://distributed-net/{distributed-net.templates}



Christian PERRIER wrote:
> --- distributed-net.old/debian/distributed-net.templates	2014-03-08 17:59:47.657657134 +0100
> +++ distributed-net/debian/distributed-net.templates	2014-03-17 08:34:51.896534125 +0100
> @@ -5,12 +5,12 @@
>   The distributed.net client needs to be configured before it can be used.
>   While most options have reasonable defaults, you need to specify the e-mail
>   address to which you would like distributed.net to credit any work done by
> + the client. If you are installing the distributed-net package for the first
>   time, then you must configure the client, otherwise the distributed.net client
>   will refuse to start.
>   .
>   When the distributed.net client is run as a daemon (via /etc/init.d/distributed-net),
>   the output will be redirected to /var/log/distributed-net.log.  You do not
> + need to set up a log file. Since the init script is controlling the
> + distributed.net client, you should not enable "quiet mode" as that breaks the
>   init script.

Looks okay.  I have a vague feeling the last paragraph could be
clearer and/or more concise, but it'll do.

In the control file:

> Package: distributed-net
[...]
> Description: donate unused CPU cycles - client for distributed.net

That's not in DevRef-favoured noun phrase format; it's not a big deal,
but it wouldn't be hard to turn it into, say:

  Description: client to donate unused CPU cycles to distributed.net

[...]
>  Since this time, distributed.net has changed their focus from solely
>  cracking RSA's RC5 and DES projects to working on more diverse
>  distributed computing problems.

Are we thinking of distributed.net as singular ("has") or plural
("their")?  en_GB tends to tolerate this sort of fuzziness more than
en_US; I'd suggest resolving it by saying:

   Since this time, distributed.net's focus has changed from solely
   [...]

(I was also thinking it should be "RSA Security's" projects, but no,
apparently their trade name is just "RSA".)

>  .
>  The ongoing projects are RC5-72 and Optimal Golomb Rulers (25-mark), the
>  latter of which has practical applications in science. There are also a
>  number of other projects which are either periodic or upcoming. You may
>  choose which project you wish to participate in.

RC5-72 is likely to be "ongoing" for centuries, but the mention of
OGR-25 is long out of date - the homepage has a headline announcing
the start of the effort for OGR-28.  I've corrected the number, but
maybe it would be best to drop the bit in parentheses?

>  .
>  By installing this package, unused CPU cycles on your computer will be used
>  to work on cracking the code. There should be no noticeable slowdown of
>  your system, since the client runs niced, and only uses CPU time when
>  your computer would otherwise be idle.

The grammar of that first sentence is a bit wonky (and then once I'm
editing it I'd prefer to avoid the repetition of "used").

   Installing this package will allow unused CPU cycles from your computer to
   contribute to cracking the code. [...]

>  .
>  For more information, see http://www.distributed.net/

That's fairly obvious, and especially redundant now it's got a
"Homepage:".
-- 
JBR	with qualifications in linguistics, experience as a Debian
	sysadmin, and probably no clue about this particular package
diff -ru distributed-net-2.9111.520.pristine/debian/control distributed-net-2.9111.520/debian/control
--- distributed-net-2.9111.520.pristine/debian/control	2014-02-28 20:08:12.000000000 +0000
+++ distributed-net-2.9111.520/debian/control	2014-03-17 09:43:55.778909213 +0000
@@ -13,7 +13,7 @@
 Suggests: apmd, acpid
 Depends: host | bind9-host, libc6 | libc6.1, ${misc:Depends}
 Recommends: logrotate
-Description: donate unused CPU cycles - client for distributed.net
+Description: client to donate unused CPU cycles to distributed.net
  Donate your extra CPU cycles to a worthy cause!
  .
  distributed.net started in 1997 as a project whose purpose was to win a
@@ -23,18 +23,16 @@
  use of cryptography, that the standards allowed are too weak for general
  use.
  .
- Since this time, distributed.net has changed their focus from solely
+ Since this time, distributed.net's focus has changed from solely
  cracking RSA's RC5 and DES projects to working on more diverse
  distributed computing problems.
  .
- The ongoing projects are RC5-72 and Optimal Golomb Rulers (25-mark), the
+ The ongoing projects are RC5-72 and Optimal Golomb Rulers (28-mark), the
  latter of which has practical applications in science. There are also a
  number of other projects which are either periodic or upcoming. You may
  choose which project you wish to participate in.
  .
- By installing this package, unused CPU cycles on your computer will be used
- to work on cracking the code. There should be no noticeable slowdown of
+ Installing this package will allow unused CPU cycles on your computer to
+ contribute to cracking the code. There should be no noticeable slowdown of
  your system, since the client runs niced, and only uses CPU time when
  your computer would otherwise be idle.
- .
- For more information, see http://www.distributed.net/
diff -ru distributed-net-2.9111.520.pristine/debian/distributed-net.templates distributed-net-2.9111.520/debian/distributed-net.templates
--- distributed-net-2.9111.520.pristine/debian/distributed-net.templates	2014-02-28 22:11:00.000000000 +0000
+++ distributed-net-2.9111.520/debian/distributed-net.templates	2014-03-17 09:30:14.166789585 +0000
@@ -5,12 +5,12 @@
  The distributed.net client needs to be configured before it can be used.
  While most options have reasonable defaults, you need to specify the e-mail
  address to which you would like distributed.net to credit any work done by
- the client.  If you are installing the distributed-net package for the first
+ the client. If you are installing the distributed-net package for the first
  time, then you must configure the client, otherwise the distributed.net client
  will refuse to start.
  .
  When the distributed.net client is run as a daemon (via /etc/init.d/distributed-net),
  the output will be redirected to /var/log/distributed-net.log.  You do not
- need to set up a log file.  Since the init script is controlling the
- distributed.net client, you should not enable "quiet mode" as that break the
+ need to set up a log file. Since the init script is controlling the
+ distributed.net client, you should not enable "quiet mode" as that breaks the
  init script.
Template: distributed-net/fullconfig
Type: boolean
Default: false
_Description: Run the distributed.net client configuration utility?
 The distributed.net client needs to be configured before it can be used.
 While most options have reasonable defaults, you need to specify the e-mail
 address to which you would like distributed.net to credit any work done by
 the client. If you are installing the distributed-net package for the first
 time, then you must configure the client, otherwise the distributed.net client
 will refuse to start.
 .
 When the distributed.net client is run as a daemon (via /etc/init.d/distributed-net),
 the output will be redirected to /var/log/distributed-net.log.  You do not
 need to set up a log file. Since the init script is controlling the
 distributed.net client, you should not enable "quiet mode" as that breaks the
 init script.
Source: distributed-net
Section: non-free/misc
Priority: optional
Maintainer: James E. Stark <jstark@ieee.org>
Homepage: http://www.distributed.net/
Build-Depends: debhelper (>= 5.0.0), po-debconf
Standards-Version: 3.9.5

Package: distributed-net
Architecture: i386 amd64 sparc powerpc armel mipsel
Conflicts: rc564
Replaces: rc564
Suggests: apmd, acpid
Depends: host | bind9-host, libc6 | libc6.1, ${misc:Depends}
Recommends: logrotate
Description: client to donate unused CPU cycles to distributed.net
 Donate your extra CPU cycles to a worthy cause!
 .
 distributed.net started in 1997 as a project whose purpose was to win a
 series of contests sponsored by RSA Data Security Inc., to crack their RC5
 encryption by brute-force methods. These contests were meant to show
 governments of nations such as the United States, who limit exports or
 use of cryptography, that the standards allowed are too weak for general
 use.
 .
 Since this time, distributed.net's focus has changed from solely
 cracking RSA's RC5 and DES projects to working on more diverse
 distributed computing problems.
 .
 The ongoing projects are RC5-72 and Optimal Golomb Rulers (28-mark), the
 latter of which has practical applications in science. There are also a
 number of other projects which are either periodic or upcoming. You may
 choose which project you wish to participate in.
 .
 Installing this package will allow unused CPU cycles on your computer to
 contribute to cracking the code. There should be no noticeable slowdown of
 your system, since the client runs niced, and only uses CPU time when
 your computer would otherwise be idle.

Reply to: