Bug#392152: gnome-mag: Should document and use one of -v/-h/-f by default

[Samuel Thibault]

Package: gnome-mag
Version: 1:0.13.1-1
Severity: wishlist

Hi,

I've just tried magnifier this way:

$ magnifier

And apart a few warnings, nothing came out.  Then I digged into --help,
and tried a bunch of options before realizing that one needs to specify
either -v, -h or -f.  Not only this is not documented, but it is not
very easy to find out.

It would hence be useful to:

- rephrase --help a bit:

Usage: magnifier -v | -h | -f [OPTION...]

For documenting that -v/-h/-f is needed

- complain if none of -v/-h/-f is given (and tell that one of them
  should be given).

- use -v by default (for instance), so that just running "magnifier"
  alone will at least provide some result.

Samuel

-- System Information:
Debian Release: testing/unstable
  APT prefers testing
  APT policy: (990, 'testing'), (500, 'unstable'), (500, 'stable'), (1, 'experimental')
Architecture: i386 (i686)
Shell:  /bin/sh linked to /bin/bash
Kernel: Linux 2.6.18
Locale: LANG=fr_FR at euro, LC_CTYPE=fr_FR at euro (charmap=ISO-8859-15)

Versions of packages gnome-mag depends on:
ii  libatk1.0-0                  1.12.2-1    The ATK accessibility toolkit
ii  libatspi1.0-0                1.7.11-1    C binding libraries of at-spi for 
ii  libbonobo2-0                 2.14.0-1    Bonobo CORBA interfaces library
ii  libc6                        2.3.6.ds1-4 GNU C Library: Shared libraries
ii  libcairo2                    1.2.4-1     The Cairo 2D vector graphics libra
ii  libfontconfig1               2.4.1-2     generic font configuration library
ii  libglib2.0-0                 2.12.3-2    The GLib library of C routines
ii  libgnome-mag2                1:0.13.1-1  screen magnification library for t
ii  libgtk2.0-0                  2.8.20-1    The GTK+ graphical user interface 
ii  libice6                      1:1.0.1-2   X11 Inter-Client Exchange library
ii  liborbit2                    1:2.14.0-2  libraries for ORBit2 - a CORBA ORB
ii  libpango1.0-0                1.14.4-2    Layout and rendering of internatio
ii  libpopt0                     1.10-3      lib for parsing cmdline parameters
ii  libsm6                       1:1.0.1-3   X11 Session Management library
ii  libx11-6                     2:1.0.0-9   X11 client-side library
ii  libxcursor1                  1.1.7-4     X cursor management library
ii  libxdamage1                  1:1.0.3-2   X11 damaged region extension libra
ii  libxext6                     1:1.0.1-2   X11 miscellaneous extension librar
ii  libxfixes3                   1:4.0.1-4   X11 miscellaneous 'fixes' extensio
ii  libxi6                       1:1.0.1-3   X11 Input extension library
ii  libxinerama1                 1:1.0.1-4.1 X11 Xinerama extension library
ii  libxrandr2                   2:1.1.0.2-4 X11 RandR extension library
ii  libxrender1                  1:0.9.1-3   X Rendering Extension client libra

gnome-mag recommends no packages.

-- no debconf information

-- 
Samuel Thibault <samuel.thibault at ens-lyon.org>
The only "intuitive" interface is the nipple. After that, it's all learned.
(Bruce Ediger, bediger at teal.csn.org, in comp.os.linux.misc, on X interfaces.)