Bug#383477: man page doesn't document gksudo, or -S option

[Chris Moore]

Package: gksu
Version: 1.9.3-2
Severity: normal

"man gksudo" shows the same man page as "man gksu".

The man page shown doesn't mention the difference between gksu and
gksudo, namely that gksu acts like 'su' and gksudo acts like 'sudo'.
In fact, the man page doesn't even mention gksudo at all.

Older versions of the package had a clearer and more complete man
page, which included documentation of the -S option:

------------------------------------------------------------------------
       --sudo-mode, -S

              Use sudo instead of su as backend authentication system.  Notice
              that the X authorization magic will not work when using sudo for
              target users other than root.
------------------------------------------------------------------------

and a more complete description:

------------------------------------------------------------------------
DESCRIPTION
       This manual page documents briefly gksu and gksudo

       gksu  is a frontend to su and gksudo is a frontend to sudo.  Their pri‐
       mary purpose is to run graphical commands that need  root  without  the
       need to run an X terminal emulator and using su directly.
------------------------------------------------------------------------

( see
http://archive.ubuntu.com/ubuntu/pool/main/g/gksu/gksu_1.3.7-0ubuntu9_i386.deb
for an example of a package with the old man page).

Is there a good reason why these details have been removed from the
manpage?


-- System Information:
Debian Release: testing/unstable
  APT prefers unstable
  APT policy: (500, 'unstable')
Architecture: i386 (i686)
Shell:  /bin/sh linked to /bin/bash
Kernel: Linux 2.6.17-2-686
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8)

Versions of packages gksu depends on:
ii  gnome-keyring                0.4.9-1     GNOME keyring services (daemon and
ii  libatk1.0-0                  1.12.1-1    The ATK accessibility toolkit
ii  libbonobo2-0                 2.14.0-1    Bonobo CORBA interfaces library
ii  libc6                        2.3.6-19    GNU C Library: Shared libraries
ii  libcairo2                    1.2.2-1     The Cairo 2D vector graphics libra
ii  libfontconfig1               2.3.2-7     generic font configuration library
ii  libgconf2-4                  2.14.0-4    GNOME configuration database syste
ii  libgksu2-0                   1.9.8-1     library providing su and sudo func
ii  libglib2.0-0                 2.10.3-3    The GLib library of C routines
ii  libgnome-keyring0            0.4.9-1     GNOME keyring services library
ii  libgnomevfs2-0               2.14.2-1    GNOME virtual file-system (runtime
ii  libgtk2.0-0                  2.8.20-1    The GTK+ graphical user interface 
ii  libnautilus-extension1       2.14.3-1    libraries for nautilus components 
ii  liborbit2                    1:2.14.0-2  libraries for ORBit2 - a CORBA ORB
ii  libpango1.0-0                1.12.3-1+b1 Layout and rendering of internatio
ii  libstartup-notification0     0.8-1       library for program launch feedbac
ii  libx11-6                     2:1.0.0-8   X11 client-side library
ii  libxcursor1                  1.1.5.2-5   X cursor management library
ii  libxext6                     1:1.0.0-4   X11 miscellaneous extension librar
ii  libxfixes3                   1:3.0.1.2-4 X11 miscellaneous 'fixes' extensio
ii  libxi6                       1:1.0.0-5   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.0.2-4 X Rendering Extension client libra
ii  sudo                         1.6.8p12-4  Provide limited super user privile

gksu recommends no packages.

-- no debconf information