[Portland] [PATCH 1/2] xdg-email: Explain in man page how to set the default mailer

[Jonathan Nieder]

---
 scripts/desc/xdg-email.xml |   85 ++++++++++++++++++++++++++++++++++++++++++-
 1 files changed, 83 insertions(+), 2 deletions(-)

diff --git a/scripts/desc/xdg-email.xml b/scripts/desc/xdg-email.xml
index d9bc3d8..9d848ff 100755
--- a/scripts/desc/xdg-email.xml
+++ b/scripts/desc/xdg-email.xml
@@ -8,7 +8,7 @@
   <refentryinfo>
     <title>xdg-email Manual</title>
     <copyright>
-      <year>2006</year>
+      <year>2010</year>
     </copyright>
     <author>
       <firstname>Kevin</firstname>
@@ -80,7 +80,7 @@
       It is not recommended to use xdg-email as root.
     </para>
     <para>
-      See http://portland.freedesktop.org/EmailConfig for information on
+      See <xref linkend="email_config" /> for information on
       how the user can change the e-mail composer that is used.
     </para>
   </refsect1>
@@ -182,6 +182,87 @@
       </varlistentry>
     </variablelist>
   </refsect1>
+  <refsect1 id="email_config">
+    <title>Mailer Configuration</title>
+    <para>
+      xdg-email opens the default email composer.  How the user can set that
+      depends on the desktop environment being used:
+    </para>
+    <refsect2 id="gnome_config">
+      <title>GNOME</title>
+      <orderedlist>
+        <listitem>
+          <simpara>
+            Open the System menu from the GNOME panel and select
+            Preferences → Preferred Applications.
+          </simpara>
+        </listitem>
+        <listitem>
+          <simpara>
+            Set the Mail Reader in the bottom half of the
+            Internet tab of the Preferred Applications window.
+          </simpara>
+        </listitem>
+      </orderedlist>
+    </refsect2>
+    <refsect2 id="kde_config">
+      <title>KDE</title>
+      <orderedlist>
+        <listitem>
+          <simpara>
+            Open System Settings → Personal → Default Applications
+          </simpara>
+        </listitem>
+        <listitem>
+          <simpara>
+            From the left pane, choose Email Client.
+          </simpara>
+        </listitem>
+        <listitem>
+          <simpara>
+            To use a composer other than KMail, select the "Use a different
+            email client" radio button, enter "&lt;mailername&gt; %u"
+            in the text box, and click Apply.
+          </simpara>
+        </listitem>
+      </orderedlist>
+    </refsect2>
+    <refsect2 id="xfce_config">
+      <title>XFCE</title>
+      <orderedlist>
+        <listitem>
+          <simpara>
+            Press the Settings button on the XFCE panel.
+          </simpara>
+        </listitem>
+        <listitem>
+          <simpara>
+            Select Preferred Applications.
+          </simpara>
+        </listitem>
+        <listitem>
+          <simpara>
+            Set the Mail Reader in the bottom half of the Internet tab
+            of the Preferred Applications window.
+          </simpara>
+        </listitem>
+      </orderedlist>
+    </refsect2>
+    <refsect2 id="generic_config">
+      <title>No desktop environment</title>
+      <para>
+        If no desktop environment is in use, xdg-email will use
+        the browser set through the BROWSER environment variable
+        as an e-mail composer (with syntax the same as in xdg-open).
+      </para>
+    </refsect2>
+    <refsect2 id="config_see_also">
+      <title>See also</title>
+      <para>
+        http://portland.freedesktop.org/EmailConfig
+      </para>
+    </refsect2>
+  </refsect1>
   <refsect1 id="env_vars">
     <title>Environment Variables</title>
     <para>
-- 
1.7.2.3