[kde-doc-english] [kde-cli-tools] doc/kdesu: doc update for man page CCMAIL:251560

[Aleix Pol]

Git commit c51b0e6562010734fca223f10a9685ca9a0c80de by Aleix Pol, on behalf of Burkhard Lück.
Committed on 18/09/2010 at 18:40.
Pushed by apol into branch 'master'.

doc update for man page CCMAIL:251560

svn path=/trunk/KDE/kdebase/runtime/; revision=1176809

M  +29   -11   doc/kdesu/man-kdesu.1.docbook

http://commits.kde.org/kde-cli-tools/c51b0e6562010734fca223f10a9685ca9a0c80de

diff --git a/doc/kdesu/man-kdesu.1.docbook b/doc/kdesu/man-kdesu.1.docbook
index b9c5ac4..491425d 100644
--- a/doc/kdesu/man-kdesu.1.docbook
+++ b/doc/kdesu/man-kdesu.1.docbook
@@ -7,7 +7,7 @@
 <refentryinfo>
 <title>KDE User's Manual</title>
 <author>&Lauri.Watts; &Lauri.Watts.mail;</author>
-<date>Jun 7, 2005</date>
+<date>2010-09-18</date>
 <productname>K Desktop Environment</productname>
 </refentryinfo>
 
@@ -25,7 +25,7 @@
 <cmdsynopsis>
 <command>kdesu</command>
 
-<group choice="opt"><option>-c</option></group>
+<group choice="opt"><option>-c</option> <replaceable> command</replaceable></group>
 <group choice="opt"><option>-d</option></group>
 <group choice="opt"><option>-f</option> <replaceable> file</replaceable></group>
 <group choice="opt"><option>-i</option> <replaceable> icon name</replaceable></group>
@@ -34,13 +34,14 @@
 <group choice="opt"><option>-r</option></group>
 <group choice="opt"><option>-s</option></group>
 <group choice="opt"><option>-t</option></group>
-<group choice="opt"><option>-u</option> <replaceable>
-user</replaceable></group>
-<group choice="opt"><option>--nonewdcop</option></group>
+<group choice="opt"><option>-u</option> <replaceable> user</replaceable></group>
+<group choice="opt"><option>--noignorebutton</option></group>
+<group choice="opt"><option>--attach</option> <replaceable> winid</replaceable></group>
+<!--group choice="opt"><option>- -nonewdcop</option></group>
 
 <group><arg choice="req"><replaceable>command</replaceable> <arg><replaceable>arg1</replaceable></arg>
 	  <arg><replaceable>arg2</replaceable></arg>
-          <arg rep="repeat"><replaceable></replaceable></arg></arg></group>
+          <arg rep="repeat"><replaceable></replaceable></arg></arg></group-->
 </cmdsynopsis>
 <cmdsynopsis>
 <command>kdesu</command>
@@ -63,6 +64,11 @@ password once for each command.</para>
 
 <para>This program is meant to be started from the command line or
 from <filename>.desktop</filename> files.</para>
+
+<para>Since <command>kdesu</command> is no longer installed in <userinput>
+$(kde4-config --prefix)</userinput>/bin but in <userinput>kde4-config --path libexec</userinput> 
+and therefore not in your <envar>Path</envar>, you have to use <userinput>$(kde4-config 
+--path libexec)<command>kdesu</command></userinput> to launch <command>kdesu</command>.</para>
 </refsect1>
 
 <refsect1>
@@ -70,11 +76,11 @@ from <filename>.desktop</filename> files.</para>
 
 <variablelist>
 <varlistentry>
-<term><option>-c <replaceable>program</replaceable></option></term>
-<listitem><para>This specifies the program to run as root. It has to be passed
+<term><option>-c <replaceable>command</replaceable></option></term>
+<listitem><para>This specifies the command to run as root. It has to be passed
 in one argument. So if, for example, you want to start a new file manager, you
-would enter at the prompt: <userinput><command>kdesu <option>-c <replaceable>kfm
--sw</replaceable></option></command></userinput></para></listitem>
+would enter at the prompt: <userinput>$(kde4-config --path libexec)<command>kdesu <option>-c <replaceable>
+&dolphin;</replaceable></option></command></userinput></para></listitem>
 </varlistentry>
 <varlistentry>
 <term><option>-d</option></term>
@@ -142,6 +148,18 @@ password.</para>
 </listitem>
 </varlistentry>
 
+<varlistentry>
+<term><option>--noignorebutton</option></term>
+<listitem><para>Do not display an ignore button.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><option>--attach</option> <replaceable> winid</replaceable></term>
+<listitem><para>Makes the dialog transient for an X app specified by winid.</para>
+</listitem>
+</varlistentry>
+
 </variablelist>
 
 </refsect1>
@@ -163,7 +181,7 @@ url="help:/kdesu">help:/kdesu</ulink>
 <para>Run <command>kfmclient</command> as user <systemitem
 class="username">jim</systemitem>, and show the &konqueror; icon in the
 password dialog:</para>
-<screen><userinput><command>kdesu</command> <option>-u jim</option> <option>-i konqueror</option> <command>kfmclient</command></userinput></screen>
+<screen><userinput>$(kde4-config --path libexec)<command>kdesu</command> <option>-u jim</option> <option>-i konqueror</option> <command>kfmclient</command></userinput></screen>
 
 </refsect1>