diff options
| author | David Zeuthen <zeuthen@gmail.com> | 2012-11-14 13:23:19 -0500 |
|---|---|---|
| committer | David Zeuthen <zeuthen@gmail.com> | 2012-11-14 13:23:19 -0500 |
| commit | ed39d825e4e6afa9aa446dce86fe230832c143e1 (patch) | |
| tree | e5a674e207ab5c609ba987eb9bf97e242aa3be2f | |
| parent | 34cb6353b9affd6c04ea480df5fc39d0ca72319d (diff) | |
docs: mention the audience for authorization rules
Signed-off-by: David Zeuthen <zeuthen@gmail.com>
| -rw-r--r-- | docs/man/polkit.xml | 13 | ||||
| -rw-r--r-- | docs/polkit/overview.xml | 10 |
2 files changed, 23 insertions, 0 deletions
diff --git a/docs/man/polkit.xml b/docs/man/polkit.xml index 1aebfc9..aaac4f4 100644 --- a/docs/man/polkit.xml +++ b/docs/man/polkit.xml @@ -503,6 +503,19 @@ System Context | | (in other words, the JavaScript interpreter used may change in future versions of polkit). </para> + <para> + Authorization rules are intended for two specific audiences + </para> + <itemizedlist mark='opencircle' spacing='compact'> + <listitem><para>System Administrators</para></listitem> + <listitem><para>Special-purpose Operating Systems / Environments</para></listitem> + </itemizedlist> + <para> + and those audiences only. In particular, applications, + mechanisms and general-purpose operating systems must never + include any authorization rules. + </para> + <refsect2 id="polkit-rules-polkit"> <title>The <type>Polkit</type> type</title> diff --git a/docs/polkit/overview.xml b/docs/polkit/overview.xml index 45cdba0..8d22570 100644 --- a/docs/polkit/overview.xml +++ b/docs/polkit/overview.xml @@ -196,6 +196,16 @@ </para> </listitem> + <listitem> + <para> + <emphasis role='bold'>DON'T</emphasis> include any + authorization rules with your application as this is only + intended for administrators and special-purpose operating + systems / environments. See <xref linkend="polkit-rules"/> + for more information. + </para> + </listitem> + </itemizedlist> </simplesect> |