kov changed gksu/branches/gksu2/ChangeLog, gksu/branches/gksu2/man/gksu.1

Sun Apr 30 20:10:22 UTC 2006

Mensagem de log: 
updated manpage using help2man


-----


Modified: gksu/branches/gksu2/ChangeLog
===================================================================

--- gksu/branches/gksu2/ChangeLog	2006-04-30 19:51:01 UTC (rev 582)
+++ gksu/branches/gksu2/ChangeLog	2006-04-30 20:10:21 UTC (rev 583)
@@ -1,5 +1,8 @@
 2006-04-30  Gustavo Noronha Silva  <kov at debian.org>
 
+	* man/gksu.1:
+	- updated using help2man
+
 	* TODO:
 	- removed;
 

Modified: gksu/branches/gksu2/man/gksu.1
===================================================================
--- gksu/branches/gksu2/man/gksu.1	2006-04-30 19:51:01 UTC (rev 582)
+++ gksu/branches/gksu2/man/gksu.1	2006-04-30 20:10:21 UTC (rev 583)
@@ -1,114 +1,64 @@
-.\"                                      Hey, EMACS: -*- nroff -*-
-.\" First parameter, NAME, should be all caps
-.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
-.\" other parameters are allowed: see man(7), man(1)
-.TH GKSU 1 "2003"
-.\" Please adjust this date whenever revising the manpage.
-.\"
-.\" Some roff macros, for reference:
-.\" .nh        disable hyphenation
-.\" .hy        enable hyphenation
-.\" .ad l      left justify
-.\" .ad b      justify to both left and right margins
-.\" .nf        disable filling
-.\" .fi        enable filling
-.\" .br        insert line break
-.\" .sp <n>    insert n+1 empty lines
-.\" for manpage-specific macros, see man(7)
+.TH GKSU "1" "April 2006" "GKsu version 1.9.0" "User Commands"
 .SH NAME
-gksu \- a Gtk+ su frontend
+GKsu \- manual page for GKsu version 1.9.0
 .SH SYNOPSIS
-\fBgksu\fR [ \fIoptions\fR ] \fI<command>\fR
-.br
-\fBgksudo\fR [ \fIoptions\fR ] \fI<command>\fR
-.SH DESCRIPTION
-This manual page documents briefly
 .B gksu
-and
-.B gksudo
-.PP
-gksu is a frontend to su and gksudo is a frontend to sudo.
-Their primary purpose is to run graphical commands that need
-root without the need to run an X terminal emulator and using
-su directly.
-.SH OPTIONS
-These programs follow the usual GNU command line syntax, with long
-options starting with two dashes (`-').
-A summary of options is included below.
-.br
-.SS "Common Options:"
+[\fI-u <user>\fR] [\fIoptions\fR] \fI<command>\fR
+.SH DESCRIPTION
+GKsu version 1.9.0
 .HP
-\fB\-\-user\fR <user>, \fB\-u\fR <user>
+\fB\-\-debug\fR, \fB\-d\fR
 .IP
-Calls <command> as the specified user
+Print information on the screen that might be
+useful for diagnosing and/or solving problems.
 .HP
-\fB\-\-message\fR <message>, \fB\-m\fR <message>
+\fB\-\-user\fR <user>, \fB\-u\fR <user>
 .IP
-Replaces the standard message shown to ask for
-password for the argument passed to the option
+Call <command> as the specified user.
 .HP
-\fB\-\-sudo\-mode\fR, \fB\-S\fR
+\fB\-\-disable\-grab\fR, \fB\-g\fR
 .IP
-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.
+Disable the "locking" of the keyboard, mouse,
+and focus done by the program when asking for
+password.
 .HP
-\fB\-\-title\fR <title>, \fB\-t\fR <title>
+\fB\-\-prompt\fR, \fB\-P\fR
 .IP
-Replaces the default title with the argument
+Ask the user if they want to have their keyboard
+and mouse grabbed before doing so.
 .HP
-\fB\-\-icon\fR <icon>, \fB\-i\fR <icon>
+\fB\-\-preserve\-env\fR, \fB\-k\fR
 .IP
-Replaces the default window icon with the argument
+Preserve the current environments, does not set $HOME
+nor $PATH, for example.
 .HP
-\fB\-\-desktop\fR <file>, \fB\-D\fR <file>
-Use a .desktop file to get the name of the application
-and the icon from.
-.HP
-\fB\-\-print\-pass\fR, \fB\-p\fR
+\fB\-\-login\fR, \fB\-l\fR
 .IP
-Asks gksu to print the password to stdout, just
-like ssh-askpass. Useful to use in scripts with
-programs that accept receiving the password on
-stdin.
+Make this a login shell. Beware this may cause
+problems with the Xauthority magic. Run xhost
+to allow the target user to open windows on your
+display!
 .HP
-\fB\-\-disable\-grab\fR, \fB\-g\fR
+\fB\-\-description\fR <description|file>, \fB\-D\fR <description|file>
 .IP
-Disables the "locking" of the keyboard, mouse,
-and focus done by the program when asking for
-password
+Provide a descriptional name for the command to
+be used in the default message, making it nicer.
+You can also provide the absolute path for a
+\&.desktop file. The Name key for will be used in
+this case.
 .HP
-\fB\-\-ssh\-fwd\fR, \fB\-s\fR
+\fB\-\-message\fR <message>, \fB\-m\fR <message>
 .IP
-Strip the host part of the $DISPLAY variable, so that
-GKSu will work on SSH X11 Forwarding.
+Replace the standard message shown to ask for
+password for the argument passed to the option.
+Only use this if \fB\-\-description\fR does not suffice.
 .HP
-\fB\-\-login\fR, \fB\-l\fR
+\fB\-\-print\-pass\fR, \fB\-p\fR
 .IP
-Makes this a login shell. Beware this may cause
-problems with the Xauthority magic. Run xhost
-to allow the target user to open windows on your
-display! This is ignored if running with sudo as
-backend for authentication.
-.HP
-\fB\-\-preserve\-env\fR, \fB\-k\fR
-.IP
-Preserve the current environments, does not set $HOME
-nor $PATH, for example.
-.SH RETURN VALUE
-On success, gksu will return 0. If an authentication error ocurred, it
-will exit with error code 3. If the user canceled the dialog or closed
-the window, it will return error code 2. On other error conditions,
-gksu will return 1.
-.SH NOTE
-Note that <command> and all its arguments should
-be passed as one single argument to
-.BR gksu
-just like one would to when using su.
-.SH SEE ALSO
+Ask gksu to print the password to stdout, just
+like ssh\-askpass. Useful to use in scripts with
+programs that accept receiving the password on
+stdin.
+.SH "SEE ALSO"
 .BR su (1),
-.BR gksuexec (1).
-.SH AUTHOR
-This manual page was written by Gustavo Noronha Silva <kov at debian.org>
-for the Debian GNU/Linux system (but may be used by others).
+.BR sudo (1)


