Add a man page for polkit-1(8)

diff --git a/docs/man/Makefile.am b/docs/man/Makefile.am
index c9f3d346f373f059a5870ea4e058177a2a811afe..4d8b7f0444f25aa101df7dff4a41be977cb82127 100644 (file)
--- a/docs/man/Makefile.am
+++ b/docs/man/Makefile.am
@@ -5,18 +5,19 @@ if MAN_PAGES_ENABLED
 
 man_MANS =                             \
        PolicyKit-1.8                   \
+       polkitd-1.8                     \
        pkexec.1                        \
        pkcheck.1                       \
        pkaction.1                      \
        $(NULL)
 
-%-1.8 %.1 : %.xml
+%.8 %.1 : %.xml
        $(XSLTPROC) -nonet --xinclude http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $<
 
 endif # MAN_PAGES_ENABLED
 
 EXTRA_DIST =                           \
-       PolicyKit.xml                   \
+       PolicyKit-1.xml                 \
        pkexec.xml                      \
        pkcheck.xml                     \
        pkaction.xml                    \

diff --git a/docs/man/PolicyKit-1.xml b/docs/man/PolicyKit-1.xml
new file mode 100644 (file)
index 0000000..ac37b66
--- /dev/null
+++ b/docs/man/PolicyKit-1.xml
@@ -0,0 +1,68 @@
+<refentry id="PolicyKit-1.8">
+  <refentryinfo>
+    <title>PolicyKit-1</title>
+    <date>January 2009</date>
+    <productname>PolicyKit-1</productname>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>PolicyKit-1</refentrytitle>
+    <manvolnum>8</manvolnum>
+    <refmiscinfo class="version"></refmiscinfo>
+  </refmeta>
+
+  <refnamediv>
+    <refname>PolicyKit-1</refname>
+    <refpurpose>Authorization API</refpurpose>
+  </refnamediv>
+
+  <refsect1><title>DESCRIPTION</title>
+    <para>
+      For more information about the big picture refer to the
+      PolicyKit specification which can be normally be found
+      under <filename>/usr/share/doc</filename>.
+    </para>
+
+    <para>
+      <emphasis>TODO:</emphasis> This manual page should contain a
+      simple introduction to PolicyKit for a system administrator
+      audience. Remains to be written.
+    </para>
+  </refsect1>
+
+
+  <refsect1><title>AUTHOR</title>
+    <para>
+      Written by David Zeuthen <email>davidz@redhat.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 or the
+      polkit-devel mailing list,
+      see the link <ulink url="http://lists.freedesktop.org/mailman/listinfo/polkit-devel"/>
+      on how to subscribe.
+    </para>
+  </refsect1>
+
+  <refsect1>
+    <title>SEE ALSO</title>
+    <para>
+      <citerefentry>
+        <refentrytitle>pkaction</refentrytitle><manvolnum>1</manvolnum>
+      </citerefentry>,
+      <citerefentry>
+        <refentrytitle>pkcheck</refentrytitle><manvolnum>1</manvolnum>
+      </citerefentry>,
+      <citerefentry>
+        <refentrytitle>pkexec</refentrytitle><manvolnum>1</manvolnum>
+      </citerefentry>,
+      <citerefentry>
+        <refentrytitle>polkitd-1</refentrytitle><manvolnum>8</manvolnum>
+      </citerefentry>
+    </para>
+  </refsect1>
+</refentry>

diff --git a/docs/man/PolicyKit.xml b/docs/man/PolicyKit.xml
deleted file mode 100644 (file)
index 2d1b757..0000000
--- a/docs/man/PolicyKit.xml
+++ /dev/null
@@ -1,65 +0,0 @@
-<refentry id="PolicyKit-1.8">
-  <refentryinfo>
-    <title>PolicyKit-1</title>
-    <date>January 2009</date>
-    <productname>PolicyKit-1</productname>
-  </refentryinfo>
-
-  <refmeta>
-    <refentrytitle>PolicyKit-1</refentrytitle>
-    <manvolnum>8</manvolnum>
-    <refmiscinfo class="version"></refmiscinfo>
-  </refmeta>
-
-  <refnamediv>
-    <refname>PolicyKit-1</refname>
-    <refpurpose>Authorization API</refpurpose>
-  </refnamediv>
-
-  <refsect1><title>DESCRIPTION</title>
-    <para>
-      For more information about the big picture refer to the
-      PolicyKit specification which can be normally be found
-      under <filename>/usr/share/doc</filename>.
-    </para>
-
-    <para>
-      <emphasis>TODO:</emphasis> This manual page should contain a
-      simple introduction to PolicyKit for a system administrator
-      audience. Remains to be written.
-    </para>
-  </refsect1>
-
-
-  <refsect1><title>AUTHOR</title>
-    <para>
-      Written by David Zeuthen <email>davidz@redhat.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 or the
-      polkit-devel mailing list,
-      see the link <ulink url="http://lists.freedesktop.org/mailman/listinfo/polkit-devel"/>
-      on how to subscribe.
-    </para>
-  </refsect1>
-
-  <refsect1>
-    <title>SEE ALSO</title>
-    <para>
-      <citerefentry>
-        <refentrytitle>pkaction</refentrytitle><manvolnum>1</manvolnum>
-      </citerefentry>,
-      <citerefentry>
-        <refentrytitle>pkcheck</refentrytitle><manvolnum>1</manvolnum>
-      </citerefentry>,
-      <citerefentry>
-        <refentrytitle>pkexec</refentrytitle><manvolnum>1</manvolnum>
-      </citerefentry>
-    </para>
-  </refsect1>
-</refentry>

diff --git a/docs/man/polkitd-1.xml b/docs/man/polkitd-1.xml
new file mode 100644 (file)
index 0000000..5a6fdee
--- /dev/null
+++ b/docs/man/polkitd-1.xml
@@ -0,0 +1,67 @@
+<?xml version="1.0"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
+               "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
+<!ENTITY version SYSTEM "../version.xml">
+]>
+<refentry id="devkit-disks-daemon.8">
+  <refentryinfo>
+    <title>polkitd-1</title>
+    <date>May 2009</date>
+    <productname>PolicyKit-1</productname>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>polkitd-1</refentrytitle>
+    <manvolnum>8</manvolnum>
+    <refmiscinfo class="version"></refmiscinfo>
+  </refmeta>
+
+  <refnamediv>
+    <refname>polkitd-1</refname>
+    <refpurpose>PolicyKit daemon</refpurpose>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>polkitd-1</command>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1><title>DESCRIPTION</title>
+    <para>
+      <command>polkitd-1</command> provides
+      the <emphasis>org.freedesktop.PolicyKit1</emphasis> D-Bus
+      service on the system message bus. Users or administrators
+      should never need to start this daemon as it will be
+      automatically started by
+      <citerefentry><refentrytitle>dbus-daemon</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+      whenever an application calls into the service.
+    </para>
+  </refsect1>
+
+  <refsect1><title>AUTHOR</title>
+    <para>
+      Written by David Zeuthen <email>davidz@redhat.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 or the
+      polkit-devel mailing list,
+      see the link <ulink url="http://lists.freedesktop.org/mailman/listinfo/polkit-devel"/>
+      on how to subscribe.
+    </para>
+  </refsect1>
+
+  <refsect1>
+    <title>SEE ALSO</title>
+    <para>
+      <citerefentry>
+        <refentrytitle>PolicyKit-1</refentrytitle><manvolnum>8</manvolnum>
+      </citerefentry>
+    </para>
+  </refsect1>
+</refentry>

diff --git a/docs/polkit/Makefile.am b/docs/polkit/Makefile.am
index 21333bf585fbfc03d204467f85c7a7e84daacf6e..d5c9182f0481b747a90e5fcba50a4b9b4fe10039 100644 (file)
--- a/docs/polkit/Makefile.am
+++ b/docs/polkit/Makefile.am
@@ -52,7 +52,7 @@ content_files =                                                                                       \
        ../../src/polkit/docbook-interface-org.freedesktop.PolicyKit1.Authority.xml                     \
        ../../src/polkit/docbook-interface-org.freedesktop.PolicyKit1.AuthorityManager.xml              \
        ../../src/polkit/docbook-interface-org.freedesktop.PolicyKit1.AuthenticationAgent.xml           \
-       ../man/PolicyKit.xml                                                                            \
+       ../man/PolicyKit-1.xml                                                                          \
        ../man/pkcheck.xml                                                                              \
        ../man/pkaction.xml                                                                             \
        ../man/pkexec.xml                                                                               \

diff --git a/docs/polkit/polkit-1-docs.xml b/docs/polkit/polkit-1-docs.xml
index 7cbac4bdba67e090d3944954dd8559e2bb337f5c..7283c989a69c9de39f5739007a91d63d169b5519 100644 (file)
--- a/docs/polkit/polkit-1-docs.xml
+++ b/docs/polkit/polkit-1-docs.xml
@@ -104,7 +104,8 @@
 
   <reference id="manpages">
     <title>Manual Pages</title>
-    <xi:include href="../man/PolicyKit.xml"/>
+    <xi:include href="../man/PolicyKit-1.xml"/>
+    <xi:include href="../man/polkitd-1.xml"/>
     <xi:include href="../man/pkcheck.xml"/>
     <xi:include href="../man/pkaction.xml"/>
     <xi:include href="../man/pkexec.xml"/>