Your message dated Mon, 16 Jul 2012 12:17:10 +0000 with message-id <[email protected]> and subject line Bug#680924: fixed in awesome 3.4.13-1 has caused the Debian Bug report #680924, regarding awesome: package description review 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.) -- 680924: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=680924 Debian Bug Tracking System Contact [email protected] with problems
--- Begin Message ---Package: awesome Version: 3.4.12-2 Severity: wishlist Tags: patch Surprisingly for such a relatively mature and high-profile package, awesome has several typos and grammar/usage problems in its package description. Currently: > Description: highly configurable, next generation framework window manager > for X ^^^^^^^^^^^^^^^ ^^^^^^^^^ ^^^^^ It's all grammatical, but while I'm editing things I would also suggest changing this synopsis, for three reasons. 1) If you're not going to mention dwm, "next generation" conveys only "it was newer than something or other else when we wrote this" (or possibly "I'm a huge fan of eighties scifi serials"). 2) This "framework window manager" jargon was specifically invented to refer to awesome, so it's not helpful for uninitiated readers. Even after reading the docs I'm not sure what it means - is it saying its layouts are based on a system of "frames", or that awesome is a window manager that provides a metaphorical framework for doing everyday work, or is it a garbled attempt to say that awesome is a "window management framework"? 3) How many window managers are there in Debian that aren't for X? > Highly configurable window manager for X. It is primarly targeted at power Sentence fragment. Besides, "highly configurable" was the one thing I was certain belonged in the short description, so it would be nice if the long description could start some other way. Typo: s/primarly/primarily/ What's missing here is any hint at what general family of window managers awesome falls into - floating, or tiling, or what? The man page is relatively informative... > users, developers and any people dealing with every day computing tasks and ^ ^^^^^^^^^^ ^ (I'll also push it towards the debian-l10n-english "house style" and insert a "Harvard" comma here.) "Any people" is subtly non-native-speakerish; maybe you were trying to avoid "anybody" (and the taboo against "singular they"). "Users" would fit, but it's repetitive. Personally I'd just say "anyone" and to hell with the taboo, but there are alternatives - for instance "and all those dealing with..." Typo: s/every day/everyday/ > want to have fine-grained control on its graphical environment. ^^^^ ^^^^^^^ ^^ ^^^ More grammar problems: * it's either "and wanting" or "who want"; * less urgently, the "to have" is redundant; if they want to have control, they want control; * "on" is the wrong preposition (it's control "over" a thing); * what's the antecedent of "its"? The window manager? The version of this text on the awesome home page has "theirs" (presumably a typo for "their"), which implies the answer is the "people". (I could complain at this stage that this is verging on false advertising - awesome *isn't* for random non-developers who just want a configurable WM; it's for users who can casually learn a new object-oriented programming language, and that pretty much rules out arts graduates like me. But since it goes on to feature Lua prominently in the next paragraph I won't bother.) > . > awesome is very extensible and programmable using the Lua programming > language. ^^^^^^^ ^^^^ ^ ^^^^^^^^^^^^ ^^^^^^^^^^^ Each of the first three paragraphs starts with the name "awesome". This isn't an advert, so you don't need to keep repeating the brand name so much. Add another comma (to keep the "very" associated with "extensible" instead of applying to "programmable" as well). I would also suggest changing "very" to "highly". Repetition of "program*"; either call awesome "scriptable" or call Lua a "scripting language" (but not both). > It provides an easily usable and very-well documented API to configure and ^^ ^^^^^^^^^^^^^ ^^^^^^^^^ Another unclear antecedent: is "it" awesome or Lua? If it's awesome, say "providing"; if it's Lua, say "which provides". Oh - the upstream version has "we"! In that case go for the former. "Easily usable" would be more natural as "easy-to-use"; on the other hand "very-well documented" has a surplus hyphen. > define the behaviour of your window manager. ^ Standardising towards en_US, so s/our/or/ - to match the man page! Throwing in a second person pronoun now seems odd after this description has referred to the various kinds of user in third person and tied itself in knots to avoid "singular they". Why not just "to define its behavior"? > . > awesome also supports tiled window management, multi-head, use XCB instead > of Xlib for better performance, does not need mouse (can be fully keyboard > driven) and implements many of the Freedesktop standards. All of these features need tweaking in one way or another. * Saying that awesome "also" supports tiled window management is strange when there has been no mention of what its *primary* layout mode is (and even stranger when most of the reviews I find on the Internet claim that it's *mainly* tiling). * "Multi-head" doesn't have a verb. If it follows on from "supports", that's slightly unidiomatic ("has multi-head support" would be okay, but a bit jargonish). * "Use XCB" should be "uses". * There's a missing article in "does not need mouse"; the parenthesised bit doesn't fit very well, and uses "fully" where I would recommend "entirely". * Again I'd insert a Harvard comma, or maybe semicolons all through. * "Many of the Freedesktop standards" is vaguely oddly phrased. Try dropping "of the". > It also use tags instead of workspace, which gives better flexibility on ^^^^ "Also" was how you introduced the last list of features - it's beginning to give the impression of a poorly planned string of afterthoughts. Online reviews say this is one of awesome's most significant selling points, so it should probably be promoted to the start of the list (followed by the one about mouse-free operation). "On" is the wrong preposition again - you probably want "in". > windows display. "Windows display"? I assume this is "the display of windows"; you could phrase that as "window display" (no need for plural marking on an attributive noun), but I would recommend "flexibility in displaying windows". > . > Remote control is possible via D-Bus. Why does this get a paragraph to itself instead of being in the list? Why would end users particularly care that it's implemented using D-Bus? And come to that, when it says "remote control", does that mean "with a Wiimote", or "over SSH", or what? The answer appears to be that it's "remote" in the sense of inter-process communication, in that awesome-client provides a CLI which can generate virtual keypresses and suchlike over a socket connection. My tentative recommended version is: | Description: highly configurable X window manager | awesome manages windows dynamically in floating or tiled layouts. It is | primarily targeted at power users, developers, and all those dealing with | everyday computing tasks and looking for fine-grained control over their | graphical environment. | . | It is highly extensible and scriptable via the Lua programming language, | providing an easy-to-use and very well documented API to configure its | behavior. | . | awesome uses tags instead of workspaces, which gives better flexibility | in displaying windows, and can be entirely keyboard-driven, not needing a | mouse. It also supports multi-headed configurations; uses XCB instead of | Xlib for better performance; implements many freedesktop standards; and | can be controlled over D-Bus from awesome-client. -- JBR with qualifications in linguistics, experience as a Debian sysadmin, and probably no clue about this particular packagediff -ru awesome-3.4.12.pristine/debian/control awesome-3.4.12/debian/control --- awesome-3.4.12.pristine/debian/control 2012-06-13 09:56:04.000000000 +0100 +++ awesome-3.4.12/debian/control 2012-07-08 20:26:39.751392353 +0100 @@ -13,19 +13,18 @@ Recommends: x11-xserver-utils, rlwrap, feh Depends: ${shlibs:Depends}, ${misc:Depends}, menu, dbus-x11 Provides: x-window-manager -Description: highly configurable, next generation framework window manager for X - Highly configurable window manager for X. It is primarly targeted at power - users, developers and any people dealing with every day computing tasks and - want to have fine-grained control on its graphical environment. +Description: highly configurable X window manager + awesome manages windows dynamically in floating or tiled layouts. It is + primarily targeted at power users, developers, and all those dealing with + everyday computing tasks and looking for fine-grained control over their + graphical environment. . - awesome is very extensible and programmable using the Lua programming language. - It provides an easily usable and very-well documented API to configure and - define the behaviour of your window manager. + It is highly extensible and scriptable via the Lua programming language, + providing an easy-to-use and very well documented API to configure its + behavior. . - awesome also supports tiled window management, multi-head, use XCB instead - of Xlib for better performance, does not need mouse (can be fully keyboard - driven) and implements many of the Freedesktop standards. - It also use tags instead of workspace, which gives better flexibility on - windows display. - . - Remote control is possible via D-Bus. + awesome uses tags instead of workspaces, which gives better flexibility + in displaying windows, and can be entirely keyboard-driven, not needing a + mouse. It also supports multi-headed configurations; uses XCB instead of + Xlib for better performance; implements many freedesktop standards; and + can be controlled over D-Bus from awesome-client.
--- End Message ---
--- Begin Message ---Source: awesome Source-Version: 3.4.13-1 We believe that the bug you reported is fixed in the latest version of awesome, 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. Julien Danjou <[email protected]> (supplier of updated awesome 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: SHA1 Format: 1.8 Date: Sun, 15 Jul 2012 15:51:10 +0200 Source: awesome Binary: awesome Architecture: source amd64 Version: 3.4.13-1 Distribution: unstable Urgency: low Maintainer: Julien Danjou <[email protected]> Changed-By: Julien Danjou <[email protected]> Description: awesome - highly configurable X window manager Closes: 680924 681364 Changes: awesome (3.4.13-1) unstable; urgency=low . * Enhance description in debian/control (Closes: #680924) (Thanks to Justin B Rye) * New upstream release + Fix focus regression (Closes: #681364) Checksums-Sha1: 8ff923043968f22f3af786b81f096775b9d9432b 2281 awesome_3.4.13-1.dsc 6127ba6048cb538b6c318d1f5d9926fa067492c1 722876 awesome_3.4.13.orig.tar.xz 5b86d643a6d675515d8b5e816b95b3feb064594a 7839 awesome_3.4.13-1.debian.tar.gz 8023d185b2c2425840f42cc1d62776d6af2a4fdd 865210 awesome_3.4.13-1_amd64.deb Checksums-Sha256: f7a1f65c940969d6bd8f4572d13d0a7671234fd1ee3de5a41157f8e056f8272d 2281 awesome_3.4.13-1.dsc 1916d969db7684e2dcf8239485e837f4dcab0c17b7bb447dabeefec6d17a1a4a 722876 awesome_3.4.13.orig.tar.xz 1b7d866b48297f3d550dafc5098365d091205852187a2a771033807c15845255 7839 awesome_3.4.13-1.debian.tar.gz e1375082664232037e36ca8b6b3ca1b0fde66630014ab3282a162c4600b618c7 865210 awesome_3.4.13-1_amd64.deb Files: 45b9050a6e3b9fba05acef85cd086d42 2281 x11 optional awesome_3.4.13-1.dsc 8449fde51c08ca69fe4c5bb831b3c618 722876 x11 optional awesome_3.4.13.orig.tar.xz fe18853e279389a3fe606d02259ef16b 7839 x11 optional awesome_3.4.13-1.debian.tar.gz 238c383178eff7d1aea9a2ea94fd165d 865210 x11 optional awesome_3.4.13-1_amd64.deb -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.12 (GNU/Linux) iQIcBAEBAgAGBQJQBAICAAoJEGEbqVCLeKXCHSIP/2D2u2xqoYZMDO2Wn8OHgfpO RESosczC7vsDe7GI+MRTxXR7HXuG9C9CxZ78jCJPcvTT7EwQBFiXQ3bWHzA5cgYx +xTLSnoT4VTmVo5r/j6/t4x2H/0NW11jnLcv39Rn2R7Edj+7cIq8C1cQB/G+dfj2 unEp3xa13F6nyS5/+M3ov249zbFvBkpnHLkPcaPjZ947ie5aJr8P6Uf1ixKeVLt7 J+8sx49uTF1zEv+qzW0WwbhBeQUEYoQaWcv9cIrfjBPWajYihyaMW9Hn4VJyZMvb LMtYkeKYBPcR+6+2mZailhaczedaTBrogqzLOwMvBigfx7COghrFQ31xIP5CT9Os KpGjUJkLcc3KMpyC1R64DgKZAa3BZQt9ihT29cz7AlY/+cRIVnwYZl8vvUvVYlQ5 Yhrn0Yk3riWtvTGIJ9rVgbHo+GUGSh/VXN4wLqUwjYiWxnb+Lh58al+JlsaLC3ul NY8zaZj5v+m7Gn1q4IawM6H04eJ0GeaVVT49hULMpFPYL92DxA6BoQgdToC8vURr Q3V2tY3fzMyblJ3Pjq4CSoj5jQY9P17rt/eh2Kvbr9br6UvOrXHOBbNLV4znciAS 2mJscy3eZ6UFvKDsvYOCCdLR+i053J/ZuSnnGj6BzTLWQ91EgzzQIy9gnwHU+cEq s8WbrbBLLOu0NSovAFPc =SSg5 -----END PGP SIGNATURE-----
--- End Message ---
