From dd8d4c97b004d1cc6cd0bdc7b4e1609acae899f4 Mon Sep 17 00:00:00 2001
From: Daniel Schaal <farbing@web.de>
Date: Sat, 2 Jul 2011 21:17:43 +0200
Subject: [PATCH] man: add manpage for start-pulseaudio-kde and
 start-pulseaudio-x11

---
 configure.ac                      |    2 +
 man/Makefile.am                   |   10 ++++++-
 man/start-pulseaudio-kde.1.xml.in |   48 +++++++++++++++++++++++++++++++++++
 man/start-pulseaudio-x11.1.xml.in |   50 +++++++++++++++++++++++++++++++++++++
 4 files changed, 108 insertions(+), 2 deletions(-)
 create mode 100644 man/start-pulseaudio-kde.1.xml.in
 create mode 100644 man/start-pulseaudio-x11.1.xml.in

diff --git a/configure.ac b/configure.ac
index 66dc9ca..077ab43 100644
--- a/configure.ac
+++ b/configure.ac
@@ -1231,6 +1231,8 @@ man/padsp.1.xml
 man/pulse-daemon.conf.5.xml
 man/pulse-client.conf.5.xml
 man/default.pa.5.xml
+man/start-pulseaudio-kde.1.xml
+man/start-pulseaudio-x11.1.xml
 ])
 
 AC_CONFIG_FILES([src/esdcompat:src/daemon/esdcompat.in], [chmod +x src/esdcompat])
diff --git a/man/Makefile.am b/man/Makefile.am
index 4f42fe2..b27a9f2 100644
--- a/man/Makefile.am
+++ b/man/Makefile.am
@@ -30,7 +30,9 @@ noinst_DATA = \
 	padsp.1.xml \
 	pulse-daemon.conf.5.xml \
 	pulse-client.conf.5.xml \
-	default.pa.5.xml
+	default.pa.5.xml \
+	start-pulseaudio-kde.1.xml \
+	start-pulseaudio-x11.1.xml
 
 xmllint: $(noinst_DATA)
 	for f in $(noinst_DATA) ; do \
@@ -51,7 +53,9 @@ dist_man_MANS = \
 	padsp.1 \
 	pulse-daemon.conf.5 \
 	pulse-client.conf.5 \
-	default.pa.5
+	default.pa.5 \
+	start-pulseaudio-kde.1 \
+	start-pulseaudio-x11.1
 
 CLEANFILES = \
 	$(dist_man_MANS)
@@ -74,6 +78,8 @@ EXTRA_DIST = \
 	pulse-daemon.conf.5.xml.in \
 	pulse-client.conf.5.xml.in \
 	default.pa.5.xml.in \
+	start-pulseaudio-kde.1.xml.in \
+	start-pulseaudio-x11.1.xml.in \
 	xmltoman \
 	xmltoman.css \
 	xmltoman.xsl \
diff --git a/man/start-pulseaudio-kde.1.xml.in b/man/start-pulseaudio-kde.1.xml.in
new file mode 100644
index 0000000..ef32906
--- /dev/null
+++ b/man/start-pulseaudio-kde.1.xml.in
@@ -0,0 +1,48 @@
+<?xml version="1.0"?><!--*-nxml-*-->
+<!DOCTYPE manpage SYSTEM "xmltoman.dtd">
+<?xml-stylesheet type="text/xsl" href="xmltoman.xsl" ?>
+
+<!--
+This file is part of PulseAudio.
+
+PulseAudio is free software; you can redistribute it and/or modify it
+under the terms of the GNU Lesser General Public License as
+published by the Free Software Foundation; either version 2.1 of the
+License, or (at your option) any later version.
+
+PulseAudio is distributed in the hope that it will be useful, but WITHOUT
+ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General
+Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public
+License along with PulseAudio; if not, write to the Free Software
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
+USA.
+-->
+
+<manpage name="start-pulseaudio-kde" section="1" desc="PulseAudio Sound Server KDE Startup Script">
+
+  <synopsis>
+    <cmd>start-pulseaudio-kde [<arg>pulseaudio options</arg>]</cmd>
+  </synopsis>
+
+  <description>
+    <p>This script starts pulseaudio (if not already running) and loads
+    module-device-manager to use KDE routing policies.</p>
+
+    <p>All arguments are directly passed to pulseaudio.</p>
+  </description>
+
+  <section name="Authors">
+    <p>The PulseAudio Developers &lt;@PACKAGE_BUGREPORT@&gt;;
+    PulseAudio is available from <url href="@PACKAGE_URL@"/></p>
+  </section>
+
+  <section name="See also">
+    <p>
+      <manref name="pulseaudio" section="1"/>
+    </p>
+  </section>
+
+</manpage>
diff --git a/man/start-pulseaudio-x11.1.xml.in b/man/start-pulseaudio-x11.1.xml.in
new file mode 100644
index 0000000..32f1571
--- /dev/null
+++ b/man/start-pulseaudio-x11.1.xml.in
@@ -0,0 +1,50 @@
+<?xml version="1.0"?><!--*-nxml-*-->
+<!DOCTYPE manpage SYSTEM "xmltoman.dtd">
+<?xml-stylesheet type="text/xsl" href="xmltoman.xsl" ?>
+
+<!--
+This file is part of PulseAudio.
+
+PulseAudio is free software; you can redistribute it and/or modify it
+under the terms of the GNU Lesser General Public License as
+published by the Free Software Foundation; either version 2.1 of the
+License, or (at your option) any later version.
+
+PulseAudio is distributed in the hope that it will be useful, but WITHOUT
+ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General
+Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public
+License along with PulseAudio; if not, write to the Free Software
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
+USA.
+-->
+
+<manpage name="start-pulseaudio-x11" section="1" desc="PulseAudio Sound Server X11 Startup Script">
+
+  <synopsis>
+    <cmd>start-pulseaudio-x11 [<arg>pulseaudio options</arg>]</cmd>
+  </synopsis>
+
+  <description>
+    <p>This script starts pulseaudio (if not already running) and loads modules to
+    publish access credentials to the PulseAudio server in the X11 root window and to synthesize
+    X11 media key events on cork/uncork requests. Additionally it registers
+    PulseAudio to the X11 Session Manager.</p>
+
+    <p>All arguments are directly passed to pulseaudio.</p>
+  </description>
+
+  <section name="Authors">
+    <p>The PulseAudio Developers &lt;@PACKAGE_BUGREPORT@&gt;;
+    PulseAudio is available from <url href="@PACKAGE_URL@"/></p>
+  </section>
+
+  <section name="See also">
+    <p>
+      <manref name="pulseaudio" section="1"/>
+    </p>
+  </section>
+
+</manpage>
-- 
1.7.5.4