Your message dated Sat, 14 Jun 2014 00:33:51 +0000 with message-id <[email protected]> and subject line Bug#724900: fixed in python-livereload 2.2.0-1 has caused the Debian Bug report #724900, regarding python-livereload: bad package description 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 [email protected] immediately.) -- 724900: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=724900 Debian Bug Tracking System Contact [email protected] with problems
--- Begin Message ---Package: python-livereload Version: 1.0.1-1 Severity: wishlist Tags: patch There are quite a few minor English language problems in the package description for python-livereload. None of them are bad enough to make it unintelligible, and description bugs like this are especially low-priority for library packages, but I happened to notice this one in the new packages list, so here's a patch. > Package: python-livereload [...] > Description: Refresh the browser automatically when a file has been updated This has a very slightly unidiomatic use of "has been" where a native-speaker would probably use simply "is"; and as it happens DevRef recommends not using (capitalised) verb-phrase-based synopses like this. "Best practice" is to use something noun-phrase-based (and uncapitalised) that fits the template "this package provides a..." > Web Developers need to refresh a browser everytime when he saved a file (css, > javascript, html), it is really boring. [...] This is full of low-level errors: * web developers don't get a capital D; * there's no such word as "everytime"; * developers can be female, and are plural anyway; * they need to refresh "their" browser rather than just "a" browser; * "saved" is the wrong tense - it's "every time X happens", present; * CSS/JavaScript/HTML shouldn't be written all-lowercase; * it's "CSS/JavaScript/HTML file", so shift the parentheses earlier; * the list needs a conjunction - "CSS, JavaScript, or HTML"; * tacking "it is really boring" on the end is ungrammatical. I suspect a real pedant might also argue that you don't "refresh" a browser; you refresh the page by reloading the browser. But even if that usage is technically wrong then it's far too late to stop it becoming the idiom that's most widely understood. I'll just make sure the word "reload" is there at least once in the description for the sake of people doing searches. > [...] LiveReload will take care of that for > you. When you saved a file, your browser will refresh itself. And what's > more, Again, "when you save", not past tense. Otherwise this is a lot better, though I would suggest stringing together everything from "LiveReload will..." instead of having so many short choppy sentences. For a start this would neatly eliminate the first problem with the following sentence. > it can do some tasks like compiling less to css before the browser > refreshing. More problems: * it's not immediately obvious what "it" is - the subject of the previous sentence was "your browser"; * "do" is weak - say "can perform"; * "some" is unnecessary here; * using "like" this way is very, very slightly colloquial - while I'm rewriting this I'll change it to a more formal "such as"; * "compiling less" would mean doing reduced amounts of compilation; * "before the browser refreshing" doesn't work, which looks like an opening for the plain noun "reload". My suggested rewrite: # Description: automatic browser refresher # It is really boring for Web developers to need to refresh their browser # every time they save a (CSS, JavaScript, or HTML) file. LiveReload will # take care of that for you, so that when you save a file, your browser # will refresh itself - and what's more, it can perform tasks such as # compiling LESS to CSS before the browser reload. (Then python-livereload-doc gets the same boilerplate plus extras, which don't need any revisions.) -- JBR with qualifications in linguistics, experience as a Debian sysadmin, and probably no clue about this particular packagediff -ru python-livereload-1.0.1.pristine/debian/control python-livereload-1.0.1/debian/control --- python-livereload-1.0.1.pristine/debian/control 2013-09-17 19:29:50.000000000 +0100 +++ python-livereload-1.0.1/debian/control 2013-09-29 13:17:11.906787208 +0100 @@ -20,21 +20,23 @@ Depends: ${python:Depends}, python2.7, ${misc:Depends} Recommends: python-pyinotify, node-less Suggests: python-livereload-doc, coffeescript, node-uglify, python-slimmer -Description: Refresh the browser automatically when a file has been updated - Web Developers need to refresh a browser everytime when he saved a file (css, - javascript, html), it is really boring. LiveReload will take care of that for - you. When you saved a file, your browser will refresh itself. And what's more, - it can do some tasks like compiling less to css before the browser refreshing. +Description: automatic browser refresher + It is really boring for Web developers to need to refresh their browser + every time they save a (CSS, JavaScript, or HTML) file. LiveReload will + take care of that for you, so that when you save a file, your browser + will refresh itself - and what's more, it can perform tasks such as + compiling LESS to CSS before the browser reload. Package: python-livereload-doc Architecture: all Section: doc Depends: ${misc:Depends}, ${sphinxdoc:Depends} Recommends: python-livereload -Description: Refresh the browser automatically when a file has been updated (documentation) - Web Developers need to refresh a browser everytime when he saved a file (css, - javascript, html), it is really boring. LiveReload will take care of that for - you. When you saved a file, your browser will refresh itself. And what's more, - it can do some tasks like compiling less to css before the browser refreshing. +Description: automatic browser refresher - documentation + It is really boring for Web developers to need to refresh their browser + every time they save a (CSS, JavaScript, or HTML) file. LiveReload will + take care of that for you, so that when you save a file, your browser + will refresh itself - and what's more, it can perform tasks such as + compiling LESS to CSS before the browser reload. . This package contains API documentation and examples.
--- End Message ---
--- Begin Message ---Source: python-livereload Source-Version: 2.2.0-1 We believe that the bug you reported is fixed in the latest version of python-livereload, 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 [email protected], and the maintainer will reopen the bug report if appropriate. Debian distribution maintenance software pp. Agustin Henze <[email protected]> (supplier of updated python-livereload 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 [email protected]) -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA512 Format: 1.8 Date: Fri, 13 Jun 2014 21:08:20 -0300 Source: python-livereload Binary: python-livereload python-livereload-doc Architecture: source all Version: 2.2.0-1 Distribution: unstable Urgency: medium Maintainer: Agustin Henze <[email protected]> Changed-By: Agustin Henze <[email protected]> Description: python-livereload - automatic browser refresher python-livereload-doc - automatic browser refresher (documentation) Closes: 724900 750720 Changes: python-livereload (2.2.0-1) unstable; urgency=medium . * Imported Upstream version 2.2.0 (Closes: #750720) * Improve package description (Closes: #724900). Thanks to Justin B Rye! * Bumped Standard-Version to 3.9.5 (no changes required) * Fix override_dh_auto_install target in debian/rules * Remove bdepends on docopt Checksums-Sha1: ab8d6b70a683a68f03a37915e4adf59fd5359d8d 2109 python-livereload_2.2.0-1.dsc ab581149704fabb03e4d678a8d0dc19d49ed7f36 22709 python-livereload_2.2.0.orig.tar.gz 178e8bd2ad2355ce24816252387e8947872aefa1 3512 python-livereload_2.2.0-1.debian.tar.xz 8478af5d3ac184c4cd90db23ff14ca502a8db0f5 18184 python-livereload_2.2.0-1_all.deb 59eb9a698a71aad5d46d7de222534883e2ca153d 22720 python-livereload-doc_2.2.0-1_all.deb Checksums-Sha256: 3d6384e6c641c78525d8682b987cf7e3d80f32572f4579ecd71e56fc17c34e78 2109 python-livereload_2.2.0-1.dsc 4339226b34a4a8b3359893d01165f5c6e4716d7dbe21ae5631b19b852f704d69 22709 python-livereload_2.2.0.orig.tar.gz a9c758977c6efef61f652a043f75534cc2710de8cc66a7e8d8e5a1be3b75f097 3512 python-livereload_2.2.0-1.debian.tar.xz ab4e75d0abb9c3adf5d33dd850e80a36d886467a48e3b7c556578cee62daa046 18184 python-livereload_2.2.0-1_all.deb a8148a47f00367a359d40600921d60d7274b7c4580bee2af3cc27c665df7a4e1 22720 python-livereload-doc_2.2.0-1_all.deb Files: 1b962e35560270a3d49d91455d87b762 18184 python optional python-livereload_2.2.0-1_all.deb ab816f7dedead4979783bcda95baaba4 22720 doc optional python-livereload-doc_2.2.0-1_all.deb 917555649fee2255941465e0c2a509e3 2109 python optional python-livereload_2.2.0-1.dsc 2cf740090b48dd2f8b77548c9d7b5825 22709 python optional python-livereload_2.2.0.orig.tar.gz ededac020414579092b25c57ebd4865f 3512 python optional python-livereload_2.2.0-1.debian.tar.xz -----BEGIN PGP SIGNATURE----- Version: GnuPG v1 iQIcBAEBCgAGBQJTm5RPAAoJEAIoUhB4kDjyCIkP/jsF9J9JVMKgGWXl9my6YXH3 GzFZUNuDnpOIKmgL2DN6BLwFnkblgdl6FQfSlZ9wnVr14pQ2fNpQy6EpEZmsN6vo wOCtTtjAiuBnV8fPNnu3i+9yjaHAiu+Y4XETsChRmKq4qjCQkIZPhh00vagyIals DlNViyUBRoJPXAXeZi9XTmVDmf9eqYw6xNrkf4Tr220WEu10xZuzLgVS42v8weqD AtdrNZhRX9V9/un/UdwmIQLCMaa1Z2Cbmb3sOV1mSirYjnmpHv/v8rzyp2gLd01A VpktuX3JPOaLHMvondX5BA1dLmnw0+ET/zaSPkPiyISuO/osW2Fr9NqV5qZB0K/R lrM+OSM8IsWbjoV1aEn+yI72yWQQLWXCWHcozGPUMrE5YAp3oJrQYgLRHWJjxznz DXSU40SNOFCQPE7Qhd19I85OpyTp/6uG0IpdxhYCLJDgNSngfV4v4kwYmmbpRygq gW6oSvD1LlcX74QMJkpUCPciAfnvGQzJvFCvILuyZDgYoz3yWu1+kqAmIuSkSdyo oYWoRBlN4Hk95PJVc9n6KxFsi1P2vkPfhWXs5zPCv9O/HSMEAFTvhzsFXB2c67hw 9sGXCQvnrlAWU0tAeHkOOCAV/tEEiePMDFJm0mr87xkPO3Mey6l84XM9N5U2xGWn ttPbSLMCx8adS+bn1fow =Ieim -----END PGP SIGNATURE-----
--- End Message ---
