From: David Zeuthen <davidz@redhat.com>
Date: Mon, 14 May 2012 17:10:02 +0000 (-0400)
Subject: Call it "Disk Manager" and reword some sections of udisks(8) man page
X-Git-Tag: upstream/2.1.2~236
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=ae4afd6f6e5930863d416b6d00e76db03e16cebb;p=platform%2Fupstream%2Fudisks2.git

Call it "Disk Manager" and reword some sections of udisks(8) man page

Signed-off-by: David Zeuthen <davidz@redhat.com>
---

diff --git a/data/udisks2.service.in b/data/udisks2.service.in
index 55663f5..8d84fec 100644
--- a/data/udisks2.service.in
+++ b/data/udisks2.service.in
@@ -1,5 +1,5 @@
 [Unit]
-Description=Storage Daemon
+Description=Disk Manager
 
 [Service]
 Type=dbus
diff --git a/doc/man/udisks.xml b/doc/man/udisks.xml
index 1124fa0..0277770 100644
--- a/doc/man/udisks.xml
+++ b/doc/man/udisks.xml
@@ -13,31 +13,26 @@
 
   <refnamediv>
     <refname>udisks</refname>
-    <refpurpose>Introduction to udisks</refpurpose>
+    <refpurpose>Disk Manager</refpurpose>
   </refnamediv>
 
   <refsect1><title>DESCRIPTION</title>
     <para>
       udisks provides interfaces to enumerate and perform operations
-      on storage devices. Any application (including unprivileged
-      ones) can access the
+      on disks and storage devices. Any application (including
+      unprivileged ones) can access the
       <citerefentry><refentrytitle>udisksd</refentrytitle><manvolnum>8</manvolnum></citerefentry>
       daemon via the name <emphasis>org.freedesktop.UDisks2</emphasis>
       on the system message bus. In addition to the D-Bus API, a
       library, <filename>libudisks2</filename> is also provided. This
       library can be used from C/C++ and any high-level language with
-      <ulink url="https://live.gnome.org/GObjectIntrospection">GObjectIntrospection</ulink>
+      <ulink
+      url="https://live.gnome.org/GObjectIntrospection">GObjectIntrospection</ulink>
       support such as Javascript and Python.
-    </para>
-    <para>
-      Except for providing a list of devices, support for udev
-      properties as well as routines used to present the devices to
-      the end user, udisks, as a system-level component, is not
-      involved with what a desktop user interface shows the user. For
-      GNOME see these <ulink
-      url="http://git.gnome.org/browse/gvfs/tree/monitor/udisks2/what-is-shown.txt">GVfs
-      notes</ulink> about what is shown in the desktop user interface
-      and how to influence it.
+      udisks is only indirectly involved in what devices and objects
+      are shown in the user interface. See these
+      <ulink url="http://git.gnome.org/browse/gvfs/tree/monitor/udisks2/what-is-shown.txt">notes</ulink>
+      for what is shown in GNOME 3.
     </para>
   </refsect1>
 
@@ -54,8 +49,6 @@
       more information (<ulink
       url="http://udisks.freedesktop.org/docs/latest/udisks-polkit-actions.html">available
       online here</ulink>).
-    </para>
-    <para>
       Note that the <literal>x-udisks-auth</literal> option can be
       used in the <filename>/etc/fstab</filename> and
       <filename>/etc/crypttab</filename> files to specify that