From 0229af0d724faa862cde63ec8c0c6448210c532c Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Wed, 26 Jun 2013 01:10:48 -0400
Subject: [PATCH] Add a man page for umount.udisks2
Some customers get upset if there are commands in /bin or /sbin
without a manual page. Since the umount interface expects its
plugins to be in /sbin, add a pro forma man page for umount.udisks2.
https://bugs.freedesktop.org/show_bug.cgi?id=66188
---
doc/man/Makefile.am | 5 ++++
doc/man/udisks.xml | 1 +
doc/man/udisksctl.xml | 1 +
doc/man/udisksd.xml | 1 +
doc/man/umount.udisks2.xml | 60 ++++++++++++++++++++++++++++++++++++++++++++++
5 files changed, 68 insertions(+)
create mode 100644 doc/man/umount.udisks2.xml
diff --git a/doc/man/Makefile.am b/doc/man/Makefile.am
index e4e8ca8..97f76dc 100644
--- a/doc/man/Makefile.am
+++ b/doc/man/Makefile.am
@@ -8,6 +8,7 @@ man_MANS += \
udisksctl.1 \
udisksd.8 \
udisks.8 \
+ umount.udisks2.8 \
$(NULL)
endif
@@ -20,10 +21,14 @@ udisksd.8 : udisksd.xml
udisks.8 : udisks.xml
$(XSLTPROC) -path "$(builddir)/.." -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $<
+umount.udisks2.8 : umount.udisks2.xml
+ $(XSLTPROC) -path "$(builddir)/.." -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $<
+
EXTRA_DIST= \
udisksctl.xml \
udisksd.xml \
udisks.xml \
+ umount.udisks2.xml \
$(NULL)
clean-local:
diff --git a/doc/man/udisks.xml b/doc/man/udisks.xml
index dc32995..e13129c 100644
--- a/doc/man/udisks.xml
+++ b/doc/man/udisks.xml
@@ -393,6 +393,7 @@
</citerefentry>,
<link linkend="udisksd.8"><citerefentry><refentrytitle>udisksd</refentrytitle><manvolnum>8</manvolnum></citerefentry></link>,
<link linkend="udisksctl.1"><citerefentry><refentrytitle>udisksctl</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>,
+ <link linkend="umount.udisks2.8"><citerefentry><refentrytitle>umount.udisks2</refentrytitle><manvolnum>8</manvolnum></citerefentry></link>,
<citerefentry><refentrytitle>gnome-disks</refentrytitle><manvolnum>1</manvolnum></citerefentry>
</para>
</refsect1>
diff --git a/doc/man/udisksctl.xml b/doc/man/udisksctl.xml
index 8f38479..a87f5f2 100644
--- a/doc/man/udisksctl.xml
+++ b/doc/man/udisksctl.xml
@@ -332,6 +332,7 @@
<para>
<link linkend="udisks.8"><citerefentry><refentrytitle>udisks</refentrytitle><manvolnum>8</manvolnum></citerefentry></link>,
<link linkend="udisksd.8"><citerefentry><refentrytitle>udisksd</refentrytitle><manvolnum>8</manvolnum></citerefentry></link>,
+ <link linkend="umount.udisks2.8"><citerefentry><refentrytitle>umount.udisks2</refentrytitle><manvolnum>8</manvolnum></citerefentry></link>,
<citerefentry>
<refentrytitle>polkit</refentrytitle><manvolnum>8</manvolnum>
</citerefentry>
diff --git a/doc/man/udisksd.xml b/doc/man/udisksd.xml
index 4ad7c31..559edf1 100644
--- a/doc/man/udisksd.xml
+++ b/doc/man/udisksd.xml
@@ -113,6 +113,7 @@
<para>
<link linkend="udisks.8"><citerefentry><refentrytitle>udisks</refentrytitle><manvolnum>8</manvolnum></citerefentry></link>,
<link linkend="udisksctl.1"><citerefentry><refentrytitle>udisksctl</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>,
+ <link linkend="umount.udisks2.8"><citerefentry><refentrytitle>umount.udisks2</refentrytitle><manvolnum>8</manvolnum></citerefentry></link>,
<citerefentry>
<refentrytitle>polkit</refentrytitle><manvolnum>8</manvolnum>
</citerefentry>,
diff --git a/doc/man/umount.udisks2.xml b/doc/man/umount.udisks2.xml
new file mode 100644
index 0000000..5c0ca0f
--- /dev/null
+++ b/doc/man/umount.udisks2.xml
@@ -0,0 +1,60 @@
+<?xml version="1.0"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+ "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
+[<!ENTITY version SYSTEM "../version.xml">]>
+<refentry id="umount.udisks2.8">
+ <refentryinfo>
+ <title>umount.udisks2</title>
+ <date>March 2013</date>
+ <productname>udisks</productname>
+ </refentryinfo>
+
+ <refmeta>
+ <refentrytitle>umount.udisks2</refentrytitle>
+ <manvolnum>8</manvolnum>
+ <refmiscinfo class="manual">System Administration</refmiscinfo>
+ <refmiscinfo class="source">udisks</refmiscinfo>
+ <refmiscinfo class="version">&version;</refmiscinfo>
+ </refmeta>
+
+ <refnamediv>
+ <refname>umount.udisks2</refname>
+ <refpurpose>unmount file systems that have been mounted by udisks</refpurpose>
+ </refnamediv>
+
+ <refsect1><title>DESCRIPTION</title>
+ <para>
+ The <command>umount.udisks2</command> program is a helper for the
+ <citerefentry><refentrytitle>umount</refentrytitle><manvolnum>8</manvolnum></citerefentry>
+ program. Its purpose is to clean up automatically created directories
+ created at file system mount-time. It should never be called directly.
+ </para>
+ </refsect1>
+
+ <refsect1><title>AUTHOR</title>
+ <para>
+ Written by David Zeuthen
+ <email><![CDATA[zeuthen@gmail.com]]></email> with a lot of help
+ from many others.
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>BUGS</title>
+ <para>
+ Please send bug reports to either the distribution bug tracker
+ or the upstream bug tracker at
+ <ulink url="http://bugs.freedesktop.org/enter_bug.cgi?product=udisks"/>.
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>SEE ALSO</title>
+ <para>
+ <link linkend="udisks.8"><citerefentry><refentrytitle>udisks</refentrytitle><manvolnum>8</manvolnum></citerefentry></link>,
+ <link linkend="udisksd.8"><citerefentry><refentrytitle>udisksd</refentrytitle><manvolnum>8</manvolnum></citerefentry></link>,
+ <link linkend="udisksctl.1"><citerefentry><refentrytitle>udisksctl</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>,
+ <link linkend="umount.8"><citerefentry><refentrytitle>umount</refentrytitle><manvolnum>8</manvolnum></citerefentry></link>,
+ </para>
+ </refsect1>
+</refentry>
--
1.8.3.1