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

Bug#787012: marked as done (lwt: package description fixes)



Your message dated Thu, 28 Jul 2016 10:09:07 +0000
with message-id <E1bSiFX-0000bU-Uk@franck.debian.org>
and subject line Bug#787012: fixed in lwt 2.5.2-1
has caused the Debian Bug report #787012,
regarding lwt: package description fixes
to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact owner@bugs.debian.org
immediately.)


-- 
787012: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=787012
Debian Bug Tracking System
Contact owner@bugs.debian.org with problems
--- Begin Message ---
Source: lwt
Version: 2.4.3-4
Severity: wishlist
Tags: patch

The package descriptions for the lwt packages have some trivial
non-native-English-speakerisms.

> Description: cooperative light-weight thread library for OCaml (runtime)

(Normally I'd recommend saying "light-weight cooperative threading
library", but presumably "Light-Weight Threads" is the canonical
expansion of "Lwt", so I'll leave the synopsis lines alone.)

>  Lwt is a library of cooperative threads implemented in monadic style.
                    ^^                                   ^
There's a missing article before that last noun phrase.  Also, a
library *of* cooperative threads would be one that *uses* cooperative
threading.  You mean:

   Lwt is a library for cooperative threads implemented in a monadic style.

>  With respect to preemptive threads, cooperative threads are not using
   ^^^^^^^^^^^^^^^                                         ^^^^^^^^^^^^^
You don't mean "with respect to"; you just mean "in contrast to" or simply
"unlike".  And "are not" is a grammar error - it should be:

   Unlike preemptive threads, cooperative threads do not use

>  a scheduler to distribute processor time between threads. Instead of
                                                                     ^^
>  this [...]
   ^^^^
The "of this" is redundant; you can just say "Instead, ..."

>  [...] each thread must tell the others that he wants to let them
                                               ^^
>  work.

The main reason I'm picking on this package description rather than
all the other not-fantastically-good-English package descriptions out
there is that even when anthropomorphised to the point of having
things they want to talk to one another about, threads are not male. 

   each thread must tell the others that it wants to let them work.

But is this true anyway?  Surely the first thread doesn't send a
message to all the others - it's just:

   each thread must announce that it wants to let the others run.

Or I could probably say it more concisely if I used the word "yield",
but then I would end up changing a lot more than is really necessary.

>  .
>  This package contains runtime libraries for programs using core Lwt.

The package-specific final paragraphs are also fine (though I've added
a "Harvard comma" to one of them).
-- 
JBR	with qualifications in linguistics, experience as a Debian
	sysadmin, and probably no clue about this particular package
diff -ru lwt-2.4.3.pristine/debian/control lwt-2.4.3/debian/control
--- lwt-2.4.3.pristine/debian/control	2013-11-09 07:10:14.000000000 +0000
+++ lwt-2.4.3/debian/control	2015-05-27 19:40:52.729740745 +0100
@@ -40,11 +40,10 @@
  liblwt-glib-ocaml-dev
 Breaks: ocsigen (<< 1.2.1)
 Description: cooperative light-weight thread library for OCaml
- Lwt is a library of cooperative threads implemented in monadic style.
- With respect to preemptive threads, cooperative threads are not using
- a scheduler to distribute processor time between threads. Instead of
- this, each thread must tell the others that he wants to let them
- work.
+ Lwt is a library for cooperative threads implemented in a monadic style.
+ Unlike preemptive threads, cooperative threads do not use a scheduler to
+ distribute processor time between threads. Instead, each thread must
+ announce that it wants to let the others run.
  .
  This package contains all the development stuff you need to use the
  core Lwt OCaml library in your programs.
@@ -59,11 +58,10 @@
 Replaces: liblwt-ocaml-dev (<< 2.3.0)
 Breaks: liblwt-ocaml-dev (<< 2.3.0)
 Description: cooperative light-weight thread library for OCaml (runtime)
- Lwt is a library of cooperative threads implemented in monadic style.
- With respect to preemptive threads, cooperative threads are not using
- a scheduler to distribute processor time between threads. Instead of
- this, each thread must tell the others that he wants to let them
- work.
+ Lwt is a library for cooperative threads implemented in a monadic style.
+ Unlike preemptive threads, cooperative threads do not use a scheduler to
+ distribute processor time between threads. Instead, each thread must
+ announce that it wants to let the others run.
  .
  This package contains runtime libraries for programs using core Lwt.
 
@@ -80,11 +78,10 @@
  liblwt-ocaml-doc,
  ocaml-findlib
 Description: cooperative OpenSSL bindings for OCaml
- Lwt is a library of cooperative threads implemented in monadic style.
- With respect to preemptive threads, cooperative threads are not using
- a scheduler to distribute processor time between threads. Instead of
- this, each thread must tell the others that he wants to let them
- work.
+ Lwt is a library for cooperative threads implemented in a monadic style.
+ Unlike preemptive threads, cooperative threads do not use a scheduler to
+ distribute processor time between threads. Instead, each thread must
+ announce that it wants to let the others run.
  .
  This package contains all the development stuff you need to use Lwt
  with cooperative OpenSSL in your programs.
@@ -99,11 +96,10 @@
 Replaces: liblwt-ocaml-dev (<= 2.3.0)
 Breaks: liblwt-ocaml-dev (<= 2.3.0)
 Description: cooperative OpenSSL bindings for OCaml (runtime)
- Lwt is a library of cooperative threads implemented in monadic style.
- With respect to preemptive threads, cooperative threads are not using
- a scheduler to distribute processor time between threads. Instead of
- this, each thread must tell the others that he wants to let them
- work.
+ Lwt is a library for cooperative threads implemented in a monadic style.
+ Unlike preemptive threads, cooperative threads do not use a scheduler to
+ distribute processor time between threads. Instead, each thread must
+ announce that it wants to let the others run.
  .
  This package contains runtime libraries for programs using Lwt with
  cooperative OpenSSL.
@@ -121,11 +117,10 @@
  liblwt-ocaml-doc,
  ocaml-findlib
 Description: cooperative GLib bindings for OCaml
- Lwt is a library of cooperative threads implemented in monadic style.
- With respect to preemptive threads, cooperative threads are not using
- a scheduler to distribute processor time between threads. Instead of
- this, each thread must tell the others that he wants to let them
- work.
+ Lwt is a library for cooperative threads implemented in a monadic style.
+ Unlike preemptive threads, cooperative threads do not use a scheduler to
+ distribute processor time between threads. Instead, each thread must
+ announce that it wants to let the others run.
  .
  This package contains all the development stuff you need to use Lwt
  with cooperative GLib in your programs.
@@ -140,11 +135,10 @@
 Replaces: liblwt-ocaml-dev (<= 2.3.0)
 Breaks: liblwt-ocaml-dev (<= 2.3.0)
 Description: cooperative GLib bindings for OCaml (runtime)
- Lwt is a library of cooperative threads implemented in monadic style.
- With respect to preemptive threads, cooperative threads are not using
- a scheduler to distribute processor time between threads. Instead of
- this, each thread must tell the others that he wants to let them
- work.
+ Lwt is a library for cooperative threads implemented in a monadic style.
+ Unlike preemptive threads, cooperative threads do not use a scheduler to
+ distribute processor time between threads. Instead, each thread must
+ announce that it wants to let the others run.
  .
  This package contains runtime libraries for programs using Lwt with
  cooperative GLib.
@@ -160,11 +154,10 @@
 Replaces: liblwt-ocaml-dev (<= 2.3.0)
 Breaks: liblwt-ocaml-dev (<= 2.3.0)
 Description: cooperative light-weight thread library (documentation)
- Lwt is a library of cooperative threads implemented in monadic style.
- With respect to preemptive threads, cooperative threads are not using
- a scheduler to distribute processor time between threads. Instead of
- this, each thread must tell the others that he wants to let them
- work.
+ Lwt is a library for cooperative threads implemented in a monadic style.
+ Unlike preemptive threads, cooperative threads do not use a scheduler to
+ distribute processor time between threads. Instead, each thread must
+ announce that it wants to let the others run.
  .
  This package contains the complete API reference for Lwt, including
- OpenSSL, GLib bindings and examples.
+ OpenSSL, GLib bindings, and examples.

--- End Message ---
--- Begin Message ---
Source: lwt
Source-Version: 2.5.2-1

We believe that the bug you reported is fixed in the latest version of
lwt, which is due to be installed in the Debian FTP archive.

A summary of the changes between this version and the previous one is
attached.

Thank you for reporting the bug, which will now be closed.  If you
have further comments please address them to 787012@bugs.debian.org,
and the maintainer will reopen the bug report if appropriate.

Debian distribution maintenance software
pp.
Stéphane Glondu <glondu@debian.org> (supplier of updated lwt package)

(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing ftpmaster@ftp-master.debian.org)


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA512

Format: 1.8
Date: Thu, 28 Jul 2016 10:40:19 +0200
Source: lwt
Binary: liblwt-ocaml-dev liblwt-ocaml liblwt-ssl-ocaml-dev liblwt-ssl-ocaml liblwt-glib-ocaml-dev liblwt-glib-ocaml liblwt-ocaml-doc
Architecture: source amd64 all
Version: 2.5.2-1
Distribution: unstable
Urgency: medium
Maintainer: Debian OCaml Maintainers <debian-ocaml-maint@lists.debian.org>
Changed-By: Stéphane Glondu <glondu@debian.org>
Description:
 liblwt-glib-ocaml - cooperative GLib bindings for OCaml (runtime)
 liblwt-glib-ocaml-dev - cooperative GLib bindings for OCaml
 liblwt-ocaml - cooperative light-weight thread library for OCaml (runtime)
 liblwt-ocaml-dev - cooperative light-weight thread library for OCaml
 liblwt-ocaml-doc - cooperative light-weight thread library (documentation)
 liblwt-ssl-ocaml - cooperative OpenSSL bindings for OCaml (runtime)
 liblwt-ssl-ocaml-dev - cooperative OpenSSL bindings for OCaml
Closes: 787012
Changes:
 lwt (2.5.2-1) unstable; urgency=medium
 .
   * New upstream release
   * Fix package description, thanks to Justin B Rye (Closes: #787012)
   * Update Vcs-*
   * Update debian/copyright
   * Bump debhelper compat to 9
   * Bump Standards-Version to 3.9.8
Checksums-Sha1:
 4fa41e6cf597da45ac850f1a1b59053dff172d85 2655 lwt_2.5.2-1.dsc
 99c0653e5422a5b80dc470f8abb83956b5628e5f 268168 lwt_2.5.2.orig.tar.gz
 bc47ea9afd9ba2d994f3ae54d53f098d6c0d2c0f 7192 lwt_2.5.2-1.debian.tar.xz
 3992899aa1ded78c284dfeff3286db29befaed8a 9924 liblwt-glib-ocaml-dbgsym_2.5.2-1_amd64.deb
 8ccd1eb529598170850bec1fa2b75f13ca7e2ceb 37906 liblwt-glib-ocaml-dev_2.5.2-1_amd64.deb
 22ea60033ab9df293710317d2caf32030e6daa57 26770 liblwt-glib-ocaml_2.5.2-1_amd64.deb
 f82253d1ea463d4d21c96f2c5347ae438b110d42 172424 liblwt-ocaml-dbgsym_2.5.2-1_amd64.deb
 1e74f5b5c3485cd41a4bbcc9604cfdafeefba902 182790 liblwt-ocaml-dev-dbgsym_2.5.2-1_amd64.deb
 5d59cd02876ac3ace1dc53c0cf6ada226775c999 2623398 liblwt-ocaml-dev_2.5.2-1_amd64.deb
 613ec4502d470e70fcf854109424a71072a26ac2 100522 liblwt-ocaml-doc_2.5.2-1_all.deb
 d69f532844cb09221fc15da00adcb453bfc43621 683494 liblwt-ocaml_2.5.2-1_amd64.deb
 f966ca99893ad0cfedc7bbd4f77d390cbf1da5c6 3866 liblwt-ssl-ocaml-dbgsym_2.5.2-1_amd64.deb
 7a24a7c3c078283a1560445ce7a81771d1c34892 45668 liblwt-ssl-ocaml-dev_2.5.2-1_amd64.deb
 7d30a95469b5a5d71c7dbc41d3a825f9400d3382 25986 liblwt-ssl-ocaml_2.5.2-1_amd64.deb
Checksums-Sha256:
 0c4f2fa752de806cc923196521fc192a793e1538114f72446462aa7009db5bf3 2655 lwt_2.5.2-1.dsc
 b319514cf51656780a8f609a63ead08d3052a442546b218530ce146d37bf6331 268168 lwt_2.5.2.orig.tar.gz
 2318290af2bfde8a2055d5f6486e2f8c177f4732c5ca53765eba4283a741b617 7192 lwt_2.5.2-1.debian.tar.xz
 42e2f045bf968fb936a2354e8ea40495686d493c04a5f7377779c21f5d24f41d 9924 liblwt-glib-ocaml-dbgsym_2.5.2-1_amd64.deb
 66b40c2545fd77bbbdb309d4bf75d6781113a5ed5a7bbc98b6c77aadfbe6f3e0 37906 liblwt-glib-ocaml-dev_2.5.2-1_amd64.deb
 fe555faed914369f4be467803385c360772a103ac164b577ee6260b85e394284 26770 liblwt-glib-ocaml_2.5.2-1_amd64.deb
 6c6b2fd24f552694869f8bcbe065d4b2f8b99465dfc9ace1728e4474c9f1bc48 172424 liblwt-ocaml-dbgsym_2.5.2-1_amd64.deb
 f5a6dca7d35d296a1e78ec4cb8065af51de86262a91a0fbb049f78280ec5ebc4 182790 liblwt-ocaml-dev-dbgsym_2.5.2-1_amd64.deb
 bb7708e919a52da88a4f66c3927843bcd9d8121bdda61fdfd10ba2195ceb9174 2623398 liblwt-ocaml-dev_2.5.2-1_amd64.deb
 95e339dfe5aaa5ed9d489359efabd94b076595e64baa86e4f338a42574ef01b3 100522 liblwt-ocaml-doc_2.5.2-1_all.deb
 7493b1184be7a94d5831780b8a96012725bddfb9f9bcb0f0e5749843788c872c 683494 liblwt-ocaml_2.5.2-1_amd64.deb
 d04d2070567bd18c53030ad907e8e1318555516a2b0ed1e5b091d2ddc780606d 3866 liblwt-ssl-ocaml-dbgsym_2.5.2-1_amd64.deb
 4cf237a96b1e32b227a893a9d510654592640e691c3c89892079687ada8bc4b8 45668 liblwt-ssl-ocaml-dev_2.5.2-1_amd64.deb
 bda337173c5f6f5ae74acfae14c0fce330527b77e20baa55ab4e96d07ddfbe5f 25986 liblwt-ssl-ocaml_2.5.2-1_amd64.deb
Files:
 66b36ee2c91ed4ef23b7f19db7efbeaf 2655 ocaml optional lwt_2.5.2-1.dsc
 69cd0b8439fe1aa548aeb669fec4f2a4 268168 ocaml optional lwt_2.5.2.orig.tar.gz
 8ac539fc5cf9284fcbeb1621a6e8c389 7192 ocaml optional lwt_2.5.2-1.debian.tar.xz
 7ec782b6a00f1c1563b17b55f7451b51 9924 debug extra liblwt-glib-ocaml-dbgsym_2.5.2-1_amd64.deb
 c89993f0a5a3eb93d8693f84678d346d 37906 ocaml optional liblwt-glib-ocaml-dev_2.5.2-1_amd64.deb
 727d91fdfda1905540f98e9386cf6a8d 26770 ocaml optional liblwt-glib-ocaml_2.5.2-1_amd64.deb
 0fd78a2582d796e48fbe2415003f1dc4 172424 debug extra liblwt-ocaml-dbgsym_2.5.2-1_amd64.deb
 786b2101fcb5eea88b65daed94c7be42 182790 debug extra liblwt-ocaml-dev-dbgsym_2.5.2-1_amd64.deb
 74988e0d3b649b5975c2dfac36e35f9a 2623398 ocaml optional liblwt-ocaml-dev_2.5.2-1_amd64.deb
 c04615a0e9682955aaaeda325e639ebc 100522 doc optional liblwt-ocaml-doc_2.5.2-1_all.deb
 de00649db0add2d668e94f94c6dc0171 683494 ocaml optional liblwt-ocaml_2.5.2-1_amd64.deb
 c4acfa20ac79b34192376e2f6a10fc1d 3866 debug extra liblwt-ssl-ocaml-dbgsym_2.5.2-1_amd64.deb
 130b3987dfb15ad4c62c3f5f51f76b9c 45668 ocaml optional liblwt-ssl-ocaml-dev_2.5.2-1_amd64.deb
 045692ce7580ab63eeb9c00d633ebce6 25986 ocaml optional liblwt-ssl-ocaml_2.5.2-1_amd64.deb

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1

iQIcBAEBCgAGBQJXmcePAAoJEHhT2k1JiBrTN4IP+wVeDZbUjmxFKPD5EPZnhU/h
zi0yd1JB6Eo3/21etCf8bsZdKw6141PCrT7WiuzU7eTrf5WL8sVNH13K6JnpLp8M
WjoeWHYIjGuGRuQp+ct7qSQ4AG4OzgvMemWnJ1T0l7ADeKt8XlehujZm3afpVdey
3SRgOHPMx2mpUhUX9W/CDxwKwQbdxC5SK74TWQ3rEupjBxYE0EZa0VwdmA5uzNq4
sJfNBH2o07BYPM799m0Jt3W/1/+HH4BxsjY9lhDlHCOVKK94d7MQnmbuPxdmzEKh
2mAlQzjqjhq46PqaYSkFJmnyRqlXwYYweehT8XDpD0XrY7IOWD4JwP0NpBz6073o
Cl4vsx5+lnV2xlsYvHZzUDTM/0MVDZ2v5LW27oq4RpOd98VDJ4vO+kUc1HzGgM09
vLlaIF2Ug6k+zzsxAxRdXpuGJMhoSs7d7plcj3e8ThHYl5yhCPKfoUxJU5OuzQOs
EksK110Px8+72efLBM+030DLTPxV031hk59cp9uRpWsKO7tUHOt3cMdeX4srNn5h
jvqSH0j4V6vVtDs16KpPqVqNkv/BaJImbxlzcuZn0flW8r6rnfSxHSA9lNDoBOsw
3b/8PwxOUtEouY+VOOtI2/uls6u2AZZf3eORctEAoXvdGZa8370yBVRihenCdCn7
XJPT+lh1lQgEMVuFtsMb
=ah7u
-----END PGP SIGNATURE-----

--- End Message ---

Reply to: