summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDavid Zeuthen <davidz@redhat.com>2012-04-24 12:25:11 -0400
committerDavid Zeuthen <davidz@redhat.com>2012-04-24 12:25:11 -0400
commitc0307cdf6912a5fbe45fea8883c93a42133e3e00 (patch)
treee05d5d155319770d7c408b3d0b125c67f11ecd40
parent93f5f5ec1cbe2678f966d93f89945a86cf76cb30 (diff)
downloadpolkit-c0307cdf6912a5fbe45fea8883c93a42133e3e00.tar.gz
Update the docs to use 'polkit' (instead of 'PolicyKit') as the name
... as much as possible. Also remove the license on the docs and the FSF's address. Also point to http://www.freedesktop.org/software/polkit/docs/latest/ as that is going to be where docs are stored, going forward. Signed-off-by: David Zeuthen <davidz@redhat.com>
-rw-r--r--docs/polkit/overview.xml38
-rw-r--r--docs/polkit/polkit-1-docs.xml55
2 files changed, 25 insertions, 68 deletions
diff --git a/docs/polkit/overview.xml b/docs/polkit/overview.xml
index 0025cd8..24440d2 100644
--- a/docs/polkit/overview.xml
+++ b/docs/polkit/overview.xml
@@ -5,11 +5,11 @@
<!ENTITY extensiondir SYSTEM "../extensiondir.xml">
]>
<part id="overview">
- <title>PolicyKit Overview</title>
+ <title>polkit Overview</title>
<chapter id="polkit-intro">
<title>Introduction</title>
<para>
- PolicyKit provides an authorization API intended to be used by
+ polkit provides an authorization API intended to be used by
privileged programs (<quote>MECHANISMS</quote>) offering service
to unprivileged programs (<quote>CLIENTS</quote>). See the
<link linkend="polkit.8">polkit</link> manual page for
@@ -18,19 +18,19 @@
</chapter>
<chapter id="polkit-apps">
- <title>Writing PolicyKit applications</title>
+ <title>Writing polkit applications</title>
<para>
- PolicyKit applications are privileged mechanisms using the
- PolicyKit authority as a decider component. To do this, a
+ polkit applications are privileged mechanisms using the
+ polkit authority as a decider component. To do this, a
<emphasis>mechanism</emphasis> use either
the <link linkend="ref-api">GObject API</link>,
the <link linkend="ref-dbus-api">D-Bus API</link> or
the <link linkend="pkcheck.1">pkcheck</link> command to
- communicate with the PolicyKit Authority.
+ communicate with the polkit Authority.
</para>
<para>
Note that <emphasis>clients</emphasis> normally doesn't use the
- PolicyKit API directly – it is intended for privileged
+ polkit API directly – it is intended for privileged
<emphasis>mechanisms</emphasis>. If a client needs to disable,
modify or remove UI elements to e.g. convey to the user that a
certain action cannot be carried out (because e.g. the user is
@@ -39,7 +39,7 @@
mechanism provide an API for this.
</para>
<para>
- If a PolicyKit application wants to handle the case where no
+ If a polkit application wants to handle the case where no
authentication agent exists (for example if the app is launched
via a
<citerefentry><refentrytitle>ssh</refentrytitle><manvolnum>1</manvolnum></citerefentry>
@@ -62,10 +62,10 @@
</chapter>
<chapter id="polkit-agents">
- <title>Writing PolicyKit Authentication Agents</title>
+ <title>Writing polkit Authentication Agents</title>
<para>
Authentication agents are provided by desktop environments. When
- an user session starts, the agent registers with the PolicyKit
+ an user session starts, the agent registers with the polkit
Authority using
the <link linkend="eggdbus-method-org.freedesktop.PolicyKit1.Authority.RegisterAuthenticationAgent">RegisterAuthenticationAgent()</link>
method. When services are needed, the authority will invoke
@@ -74,7 +74,7 @@
D-Bus interface. Once the user is authenticated, (a privileged
part of) the agent invokes
the <link linkend="eggdbus-method-org.freedesktop.PolicyKit1.Authority.AuthenticationAgentResponse">AuthenticationAgentResponse()</link>
- method. Note that the PolicyKit Authority itself does not care
+ method. Note that the polkit Authority itself does not care
how the agent authenticates the user.
</para>
<para>
@@ -91,23 +91,23 @@
</chapter>
<chapter id="polkit-extending">
- <title>Extending PolicyKit</title>
+ <title>Extending polkit</title>
<para>
- PolicyKit exports a number of extension points to
- replace/customize behavior of the PolicyKit daemon. Note that
+ polkit exports a number of extension points to
+ replace/customize behavior of the polkit daemon. Note that
all extensions run with super user privileges in the same
- process as the PolicyKit daemon.
+ process as the polkit daemon.
</para>
<para>
- The PolicyKit daemons loads extensions
+ The polkit daemons loads extensions
from the <filename>&extensiondir;</filename> directory. See
the <link linkend="gio-Extension-Points">GIO Extension Point
documentation</link> for more information about the extension
- system used by PolicyKit.
+ system used by polkit.
</para>
<para>
The following extension points are currently defined by
- PolicyKit:
+ polkit:
</para>
<formalpara>
@@ -118,7 +118,7 @@
extension point must be derived from the
PolkitBackendAuthority class. See
the <filename>src/nullbackend/</filename> directory in the
- PolicyKit sources for an example.
+ polkit sources for an example.
</para>
</formalpara>
diff --git a/docs/polkit/polkit-1-docs.xml b/docs/polkit/polkit-1-docs.xml
index 4fc8a99..21b3681 100644
--- a/docs/polkit/polkit-1-docs.xml
+++ b/docs/polkit/polkit-1-docs.xml
@@ -6,55 +6,12 @@
]>
<book id="index" xmlns:xi="http://www.w3.org/2003/XInclude">
<bookinfo>
- <title>PolicyKit Reference Manual</title>
- <releaseinfo>Version &version;</releaseinfo>
- <authorgroup>
- <author>
- <firstname>David</firstname>
- <surname>Zeuthen</surname>
- <affiliation>
- <address>
- <email>davidz@redhat.com</email>
- </address>
- </affiliation>
- </author>
- </authorgroup>
-
- <copyright>
- <year>2008-2009</year>
- <holder>The PolicyKit Authors</holder>
- </copyright>
-
- <legalnotice id="polkit-legal-notice">
- <para>
- Permission is granted to copy, distribute and/or modify this
- document under the terms of the <citetitle>GNU Free
- Documentation License</citetitle>, Version 1.1 or any later
- version published by the Free Software Foundation with no
- Invariant Sections, no Front-Cover Texts, and no Back-Cover
- Texts. You may obtain a copy of the <citetitle>GNU Free
- Documentation License</citetitle> from the Free Software
- Foundation by visiting <ulink type="http"
- url="http://www.fsf.org">their Web site</ulink> or by writing
- to:
-
- <address>
- The Free Software Foundation, Inc.,
- <street>59 Temple Place</street> - Suite 330,
- <city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode>,
- <country>USA</country>
- </address>
- </para>
-
- <para>
- Many of the names used by companies to distinguish their
- products and services are claimed as trademarks. Where those
- names appear in any freedesktop.org documentation, and those
- trademarks are made aware to the members of the
- freedesktop.org Documentation Project, the names have been
- printed in caps or initial caps.
- </para>
- </legalnotice>
+ <title>polkit Reference Manual</title>
+ <releaseinfo>
+ For version &version; — the latest version of this
+ documentation can be found at <ulink role="online-location"
+ url="http://www.freedesktop.org/software/polkit/docs/latest/">http://www.freedesktop.org/software/polkit/docs/latest/</ulink>.
+ </releaseinfo>
</bookinfo>
<xi:include href="overview.xml"/>