| @@ -0,0 +1,736 @@
+--- scripts/Makefile.in
++++ scripts/Makefile.in
+@@ -19,8 +19,8 @@
+ xdg-icon-resource \
+ xdg-open \
+ xdg-email \
+- xdg-screensaver
+-# xdg-su
++ xdg-screensaver \
++ xdg-su
+ # xdg-copy \
+ # xdg-file-dialog
+ # xdg-terminal
+--- scripts/desc/xdg-su.xml
++++ scripts/desc/xdg-su.xml
+@@ -0,0 +1,166 @@
++<?xml version="1.0"?>
++<?xml-stylesheet type="text/xsl"
++ href="http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl"?>
++<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
++ "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
++]>
++<refentry id="xdg-su">
++ <refentryinfo>
++ <title>xdg-su Manual</title>
++ <copyright>
++ <year>2006</year>
++ </copyright>
++ <author>
++ <firstname>Kevin</firstname>
++ <surname>Krammer</surname>
++ </author>
++ <address><email>kevin.krammer@gmx.at</email></address>
++ <author>
++ <firstname>Jeremy</firstname>
++ <surname>White</surname>
++ </author>
++ <address><email>jwhite@codeweavers.com</email></address>
++ <releaseinfo>This is release 0.5 of the xdg-su Manual.</releaseinfo>
++ </refentryinfo>
++
++ <refmeta>
++ <refentrytitle>xdg-su</refentrytitle>
++ <manvolnum>1</manvolnum>
++ </refmeta>
++
++ <refnamediv>
++ <refname>xdg-su</refname>
++ <refpurpose>run a GUI program as root after prompting for the root password</refpurpose>
++ </refnamediv>
++
++ <refsynopsisdiv>
++ <cmdsynopsis>
++ <command>xdg-su</command>
++ <arg><option>-u <replaceable>user</replaceable></option></arg>
++ <arg choice="plain"><option>-c <replaceable>command</replaceable></option></arg>
++ </cmdsynopsis>
++ <cmdsynopsis>
++ <command>xdg-su</command>
++ <group choice="req">
++ <arg choice="plain"><option>--help</option></arg>
++ <arg choice="plain"><option>--manual</option></arg>
++ <arg choice="plain"><option>--version</option></arg>
++ </group>
++ </cmdsynopsis>
++ </refsynopsisdiv>
++
++ <refsect1 id="description">
++ <title>Description</title>
++ <para>
++ xdg-su provides a graphical dialog that prompts the user for a password
++ to run <replaceable>command</replaceable> as <replaceable>user</replaceable>
++ or as root if no user was specified.
++ </para>
++ <para>
++ xdg-su is for use inside a desktop session only.
++ </para>
++ <para>
++ xdg-su discards any stdout and stderr output from
++ <replaceable>command</replaceable>.
++ </para>
++ </refsect1>
++ <refsect1 id="options">
++ <title>Options</title>
++ <variablelist>
++ <varlistentry>
++ <term><option>-u <replaceable>user</replaceable></option></term>
++ <listitem>
++ <simpara>
++ run <replaceable>command</replaceable> as
++ <replaceable>user</replaceable>. The default is to run as root.
++ </simpara>
++ </listitem>
++ </varlistentry>
++
++ <varlistentry>
++ <term><option>--help</option></term>
++ <listitem>
++ <simpara>
++ Show command synopsis.
++ </simpara>
++ </listitem>
++ </varlistentry>
++
++ <varlistentry>
++ <term><option>--manual</option></term>
++ <listitem>
++ <simpara>
++ Show this manualpage.
++ </simpara>
++ </listitem>
++ </varlistentry>
++
++ <varlistentry>
++ <term><option>--version</option></term>
++ <listitem>
++ <simpara>
++ Show the xdg-utils version information.
++ </simpara>
++ </listitem>
++ </varlistentry>
++
++ </variablelist>
++ </refsect1>
++ <refsect1 id="exitcodes">
++ <title>Exit Codes</title>
++ <para>
++ An exit code of 0 indicates success while a non-zero exit code
++ indicates failure. The following failure codes can be returned:
++ </para>
++ <variablelist>
++ <varlistentry>
++ <term><option>1</option></term>
++ <listitem>
++ <simpara>
++ Error in command line syntax.
++ </simpara>
++ </listitem>
++ </varlistentry>
++ <varlistentry>
++ <term><option>2</option></term>
++ <listitem>
++ <simpara>
++ One of the files passed on the command line did not exist.
++ </simpara>
++ </listitem>
++ </varlistentry>
++ <varlistentry>
++ <term><option>3</option></term>
++ <listitem>
++ <simpara>
++ A required tool could not be found.
++ </simpara>
++ </listitem>
++ </varlistentry>
++ <varlistentry>
++ <term><option>4</option></term>
++ <listitem>
++ <simpara>
++ The action failed.
++ </simpara>
++ </listitem>
++ </varlistentry>
++ </variablelist>
++ </refsect1>
++ <refsect1 id="seealso">
++ <title>See Also</title>
++ <para><citerefentry><refentrytitle>su</refentrytitle>
++ <manvolnum>1</manvolnum>
++ </citerefentry>
++ </para>
++ </refsect1>
++ <refsect1 id="examples">
++ <title>Examples</title>
++ <para>
++<programlisting>
++xdg-su -u root -c "/opt/shinythings/bin/install-GUI --install fast"
++</programlisting>
++ Runs the /opt/shinythings/bin/install-GUI command with root permissions.
++ </para>
++ </refsect1>
++</refentry>
+--- scripts/html/xdg-su.html
++++ scripts/html/xdg-su.html
+@@ -0,0 +1,36 @@
++<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>xdg-su</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="xdg-su"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>xdg-su — run a GUI program as root after prompting for the root password</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">xdg-su</code> [<code class="option">-u <em class="replaceable"><code>user</code></em></code>] <code class="option">-c <em class="replaceable"><code>command</code></em></code> </p></div><div class="cmdsynopsis"><p><code class="command">xdg-su</code> { <code class="option">--help</code> | <code class="option">--manual</code> | <code class="option">--version</code> }</p></div></div><div class="refsect1" lang="en"><a name="description"></a><h2>Description</h2><p>
++ xdg-su provides a graphical dialog that prompts the user for a password
++ to run <em class="replaceable"><code>command</code></em> as <em class="replaceable"><code>user</code></em>
++ or as root if no user was specified.
++ </p><p>
++ xdg-su is for use inside a desktop session only.
++ </p><p>
++ xdg-su discards any stdout and stderr output from
++ <em class="replaceable"><code>command</code></em>.
++ </p></div><div class="refsect1" lang="en"><a name="options"></a><h2>Options</h2><div class="variablelist"><dl><dt><span class="term"><code class="option">-u <em class="replaceable"><code>user</code></em></code></span></dt><dd>
++ run <em class="replaceable"><code>command</code></em> as
++ <em class="replaceable"><code>user</code></em>. The default is to run as root.
++ </dd><dt><span class="term"><code class="option">--help</code></span></dt><dd>
++ Show command synopsis.
|
