Package: wininfo
Version: 0.7-2
Severity: wishlist
Tags: patch

The package description is pretty good overall, but needs dusting.

> Package: wininfo
> Description: displays information about X windows under the mouse cursor

This synopsis isn't DevRef6.2.2 compliant, but more important, it
fails to distinguish the package wininfo from other tools I'm
likely to have installed already (such as the commandline tool
"xwininfo" in x11-utils).  It should make it clear that wininfo
provides a dynamically updating GUI, not just a querying utility.

>  This is a window information utility for developers of applications,
>  toolkits, and window managers. wininfo follows your pointer providing
>  information about the windows below.
>  Information presented includes:
>  .
>   - A detailed description of the window hierarchy below the pointer.
>   - Parsed interpretations of standard properties from both the
>     application window and the window manager.
>   - Information about X server resources used by the application.
>  .
>  wininfo requires an X server supporting the X-Resource
>  extension. The XFree86 server provided by Debian enables this
>  resource by default.

That last paragraph's reference to an "XFree86 server" is the part
that first attracted my attention, but rather than update it I'd
recommend simply dropping it.  Users who create an xorg.conf just to
disable thoroughly standard extensions should soon notice that this
cripples various pieces of ordinary X functionality.  Besides, when
wininfo starts failing after they do that, how likely are they to go
back to the package description for the explanation?

My suggested version (with a couple of "debian-l10n-english house
style" standardisations thrown in at no extra charge):

 Description: dynamic window information viewer
  This package provides a window information utility for developers of
  applications, toolkits, and window managers. wininfo follows your
  pointer providing information about the windows below. The information
  presented includes:
   * a detailed description of the window hierarchy below the pointer;
   * parsed interpretations of standard properties from both the
     application window and the window manager;
   * information about X server resources used by the application.

-- System Information:
Debian Release: 6.0
  APT prefers stable
  APT policy: (500, 'stable'), (200, 'squeeze-updates')
Architecture: amd64 (x86_64)

Kernel: Linux 2.6.32-5-amd64 (SMP w/2 CPU cores)
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

Versions of packages wininfo depends on:
ii  libatk1.0-0            1.30.0-1          The ATK accessibility toolkit
ii  libc6                  2.11.2-10         Embedded GNU C Library: Shared lib
ii  libcairo2              1.8.10-6          The Cairo 2D vector graphics libra
ii  libfontconfig1         2.8.0-2.1         generic font configuration library
ii  libfreetype6           2.4.2-2.1         FreeType 2 font engine, shared lib
ii  libglib2.0-0           2.24.2-1          The GLib library of C routines
ii  libgtk2.0-0            2.20.1-2          The GTK+ graphical user interface 
ii  libpango1.0-0          1.28.3-1+squeeze1 Layout and rendering of internatio
ii  libx11-6               2:1.3.3-4         X11 client-side library
ii  libxext6               2:1.1.2-1         X11 miscellaneous extension librar
ii  libxres1               2:1.0.4-1         X11 Resource extension library

wininfo recommends no packages.

wininfo suggests no packages.

-- no debconf information

-- 
JBR
Ankh kak! (Ancient Egyptian blessing)
diff -ru wininfo-0.7.pristine//debian/control wininfo-0.7/debian/control
--- wininfo-0.7.pristine//debian/control	2010-02-26 09:20:27.000000000 +0000
+++ wininfo-0.7/debian/control	2011-02-06 19:23:14.712925426 +0000
@@ -9,17 +9,12 @@
 Package: wininfo
 Architecture: any
 Depends: ${shlibs:Depends}, ${misc:Depends}
-Description: displays information about X windows under the mouse cursor
- This is a window information utility for developers of applications,
- toolkits, and window managers. wininfo follows your pointer providing 
- information about the windows below.
- Information presented includes:
- .
-  - A detailed description of the window hierarchy below the pointer.
-  - Parsed interpretations of standard properties from both the
-    application window and the window manager.
-  - Information about X server resources used by the application.
- .
- wininfo requires an X server supporting the X-Resource
- extension. The XFree86 server provided by Debian enables this
- resource by default.
+Description: dynamic window information viewer
+ This package provides a window information utility for developers of
+ applications, toolkits, and window managers. wininfo follows your
+ pointer providing information about the windows below. The information
+ presented includes:
+  * a detailed description of the window hierarchy below the pointer;
+  * parsed interpretations of standard properties from both the
+    application window and the window manager;
+  * information about X server resources used by the application.

Reply via email to