From 84e42887d413cba0039f92f0c56a25c70c20fe6e Mon Sep 17 00:00:00 2001
From: David Zeuthen <zeuthen@gmail.com>
Date: Thu, 7 Jun 2012 11:43:20 -0400
Subject: [PATCH] docs: add a "make sure your app works when there's no
 polkitd(8)" note

Signed-off-by: David Zeuthen <zeuthen@gmail.com>
---
 docs/polkit/overview.xml | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/docs/polkit/overview.xml b/docs/polkit/overview.xml
index a979172..0639d30 100644
--- a/docs/polkit/overview.xml
+++ b/docs/polkit/overview.xml
@@ -103,6 +103,28 @@
           </para>
         </listitem>
 
+        <listitem>
+          <para>
+            <emphasis role='bold'>DO</emphasis> make sure
+            your application works even when the
+            <literal>org.freedesktop.PolicyKit1</literal>
+            D-Bus service is not available (this can
+            happen if
+            <link linkend="polkitd.8"><citerefentry><refentrytitle>polkitd</refentrytitle><manvolnum>8</manvolnum></citerefentry></link>
+            is not installed or if the <emphasis>polkit.service</emphasis> systemd unit/service has been
+            <ulink url="http://0pointer.de/blog/projects/three-levels-of-off.html">masked</ulink>). If you are using the
+            <link linkend="ref-api">libpolkit-gobject-1</link> library this
+            means handling
+            <link linkend="polkit-authority-get-sync">polkit_authority_get_sync()</link>
+            or
+            <link linkend="polkit-authority-get-finish">polkit_authority_get_finish()</link>
+            returning <constant>NULL</constant>.
+            An appropriate way of dealing with the polkit authority
+            not being available, could be to allow only uid 0 to
+            perform operations, forbid all operations or something
+            else.
+          </para>
+        </listitem>
 
         <listitem>
           <para>
-- 
2.7.4