Use unique ids for sections to prevent them being autogenerated

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

diff --git a/docs/man/PolicyKit-1.xml b/docs/man/PolicyKit-1.xml
index 6b630db3dffcd770702341c4f73e59b854c9c043..4e777ba98555349779f2f2bcf704d69596fff275 100644 (file)
--- a/docs/man/PolicyKit-1.xml
+++ b/docs/man/PolicyKit-1.xml
@@ -21,7 +21,7 @@
     <refpurpose>Authorization API</refpurpose>
   </refnamediv>
 
-  <refsect1><title>OVERVIEW</title>
+  <refsect1 id="PolicyKit-1-overview"><title>OVERVIEW</title>
     <para>
       PolicyKit provides an authorization API intended to be used by
       privileged programs (<quote>MECHANISMS</quote>) offering service
@@ -46,7 +46,7 @@
 
   </refsect1>
 
-  <refsect1><title>SYSTEM ARCHITECTURE</title>
+  <refsect1 id="PolicyKit-1-system-architecture"><title>SYSTEM ARCHITECTURE</title>
     <para>
       The system architecture of PolicyKit is comprised of
       the <emphasis>Authority</emphasis> (implemented as a service on
@@ -129,7 +129,7 @@ System Context         |                        |
     </para>
   </refsect1>
 
-  <refsect1><title>AUTHENTICATION AGENTS</title>
+  <refsect1 id="PolicyKit-1-authentication-agents"><title>AUTHENTICATION AGENTS</title>
     <para>
       An authentication agent is used to make the user of a session
       prove that the user of the session really is the user (by
@@ -216,7 +216,7 @@ System Context         |                        |
     </para>
   </refsect1>
 
-  <refsect1><title>DECLARING ACTIONS</title>
+  <refsect1 id="PolicyKit-1-declaring-actions"><title>DECLARING ACTIONS</title>
     <para>
       A mechanism need to declare a set of <quote>ACTIONS</quote> in
       order to use PolicyKit. Actions correspond to operations that
@@ -401,14 +401,14 @@ System Context         |                        |
     </para>
   </refsect1>
 
-  <refsect1><title>AUTHOR</title>
+  <refsect1 id="PolicyKit-1-author"><title>AUTHOR</title>
     <para>
       Written by David Zeuthen <email>davidz@redhat.com</email> with
       a lot of help from many others.
     </para>
   </refsect1>
 
-  <refsect1>
+  <refsect1 id="PolicyKit-1-bugs">
     <title>BUGS</title>
     <para>
       Please send bug reports to either the distribution or the
@@ -418,7 +418,7 @@ System Context         |                        |
     </para>
   </refsect1>
 
-  <refsect1>
+  <refsect1 id="PolicyKit-1-see-also">
     <title>SEE ALSO</title>
     <para>
       <citerefentry>

diff --git a/docs/man/pkaction.xml b/docs/man/pkaction.xml
index 0f0afdc1d08d66e80672966351d7a706279b2124..6a54384e555e7484e45b5983d083d8faf407b754 100644 (file)
--- a/docs/man/pkaction.xml
+++ b/docs/man/pkaction.xml
@@ -52,7 +52,7 @@
 
   </refsynopsisdiv>
 
-  <refsect1>
+  <refsect1 id="pkaction-description">
     <title>DESCRIPTION</title>
     <para>
       <command>pkaction</command> is used to obtain information about registered
@@ -63,7 +63,7 @@
     </para>
   </refsect1>
 
-  <refsect1>
+  <refsect1 id="pkaction-return-values">
     <title>RETURN VALUE</title>
     <para>
       On success <command>pkaction</command> returns 0. Otherwise a
@@ -72,14 +72,14 @@
     </para>
   </refsect1>
 
-  <refsect1><title>AUTHOR</title>
+  <refsect1 id="pkaction-author"><title>AUTHOR</title>
     <para>
       Written by David Zeuthen <email>davidz@redhat.com</email> with
       a lot of help from many others.
     </para>
   </refsect1>
 
-  <refsect1>
+  <refsect1 id="pkaction-bugs">
     <title>BUGS</title>
     <para>
       Please send bug reports to either the distribution or the
@@ -89,7 +89,7 @@
     </para>
   </refsect1>
 
-  <refsect1>
+  <refsect1 id="pkaction-see-also">
     <title>SEE ALSO</title>
     <para>
       <citerefentry>

diff --git a/docs/man/pkcheck.xml b/docs/man/pkcheck.xml
index 293549d3254772444458174121911e32152bd84e..15ff1fcff9bf04d16c18558e5b80a6b4edf870f9 100644 (file)
--- a/docs/man/pkcheck.xml
+++ b/docs/man/pkcheck.xml
@@ -70,7 +70,7 @@
 
   </refsynopsisdiv>
 
-  <refsect1>
+  <refsect1 id="pkcheck-descsription">
     <title>DESCRIPTION</title>
     <para>
       <command>pkcheck</command> is used to check whether a process, specified by
@@ -86,7 +86,7 @@
     </para>
   </refsect1>
 
-  <refsect1>
+  <refsect1 id="pkcheck-return-value">
     <title>RETURN VALUE</title>
     <para>
       If the specified process is
@@ -126,7 +126,7 @@ KEY3=VALUE3
     </para>
   </refsect1>
 
-  <refsect1>
+  <refsect1 id="pkcheck-notes">
     <title>NOTES</title>
     <para>
       Since process identifiers can be recycled, the caller should always use
@@ -143,14 +143,14 @@ KEY3=VALUE3
     </para>
   </refsect1>
 
-  <refsect1><title>AUTHOR</title>
+  <refsect1 id="pkcheck-author"><title>AUTHOR</title>
     <para>
       Written by David Zeuthen <email>davidz@redhat.com</email> with
       a lot of help from many others.
     </para>
   </refsect1>
 
-  <refsect1>
+  <refsect1 id="pkcheck-bugs">
     <title>BUGS</title>
     <para>
       Please send bug reports to either the distribution or the
@@ -160,7 +160,7 @@ KEY3=VALUE3
     </para>
   </refsect1>
 
-  <refsect1>
+  <refsect1 id="pkcheck-see-also">
     <title>SEE ALSO</title>
     <para>
       <citerefentry>

diff --git a/docs/man/pkexec.xml b/docs/man/pkexec.xml
index a51dd77cb7a3d0e6ccbcaa5ce0da5307ad1f80ea..03b4f31d53250b37c0be6fd871ca6d7e28a34001 100644 (file)
--- a/docs/man/pkexec.xml
+++ b/docs/man/pkexec.xml
@@ -44,7 +44,7 @@
 
   </refsynopsisdiv>
 
-  <refsect1><title>DESCRIPTION</title>
+  <refsect1 id="pkexec-description"><title>DESCRIPTION</title>
     <para>
       <command>pkexec</command> allows an authorized user to
       execute <replaceable>PROGRAM</replaceable> as another
@@ -54,7 +54,7 @@
     </para>
   </refsect1>
 
-  <refsect1><title>RETURN VALUE</title>
+  <refsect1 id="pkexec-return-value"><title>RETURN VALUE</title>
     <para>
       Upon successful completion, the return value is the return value
       of <replaceable>PROGRAM</replaceable>. If the calling process is
@@ -64,7 +64,7 @@
     </para>
   </refsect1>
 
-  <refsect1><title>SECURITY NOTES</title>
+  <refsect1 id="pkexec-security-notes"><title>SECURITY NOTES</title>
     <para>
       Executing a program as another user is a privileged
       operation. By default the required authorization (See
@@ -228,14 +228,14 @@
     </para>
   </refsect1>
 
-  <refsect1><title>AUTHOR</title>
+  <refsect1 id="pkexec-author"><title>AUTHOR</title>
     <para>
       Written by David Zeuthen <email>davidz@redhat.com</email> with
       a lot of help from many others.
     </para>
   </refsect1>
 
-  <refsect1>
+  <refsect1 id="pkexec-bugs">
     <title>BUGS</title>
     <para>
       Please send bug reports to either the distribution or the
@@ -245,7 +245,7 @@
     </para>
   </refsect1>
 
-  <refsect1>
+  <refsect1 id="pkexec-see-also">
     <title>SEE ALSO</title>
     <para>
       <citerefentry>

diff --git a/docs/man/polkitd-1.xml b/docs/man/polkitd-1.xml
index 3080f74422dcfb23d29d8e4f996777cd24b69d97..03ea247ad0cc51d754ee12cd4a30ca4d5a53cf7b 100644 (file)
--- a/docs/man/polkitd-1.xml
+++ b/docs/man/polkitd-1.xml
@@ -27,7 +27,7 @@
     </cmdsynopsis>
   </refsynopsisdiv>
 
-  <refsect1><title>DESCRIPTION</title>
+  <refsect1 id="polkitd-1-description"><title>DESCRIPTION</title>
     <para>
       <command>polkitd-1</command> provides
       the <emphasis>org.freedesktop.PolicyKit1</emphasis> D-Bus
@@ -39,14 +39,14 @@
     </para>
   </refsect1>
 
-  <refsect1><title>AUTHOR</title>
+  <refsect1 id="polkitd-1-author"><title>AUTHOR</title>
     <para>
       Written by David Zeuthen <email>davidz@redhat.com</email> with
       a lot of help from many others.
     </para>
   </refsect1>
 
-  <refsect1>
+  <refsect1 id="polkitd-1-bugs">
     <title>BUGS</title>
     <para>
       Please send bug reports to either the distribution or the
@@ -56,7 +56,7 @@
     </para>
   </refsect1>
 
-  <refsect1>
+  <refsect1 id="polkitd-1-see-also">
     <title>SEE ALSO</title>
     <para>
       <citerefentry>

diff --git a/docs/polkit/overview.xml b/docs/polkit/overview.xml
index 57544d7c057e78053851bc50edb1258e0a711b9a..665ca3580a78ca2965243546a5a8c2001f6c747d 100644 (file)
--- a/docs/polkit/overview.xml
+++ b/docs/polkit/overview.xml
@@ -6,7 +6,7 @@
 ]>
 <part id="overview">
   <title>PolicyKit Overview</title>
-  <chapter>
+  <chapter id="polkit-intro">
     <title>Introduction</title>
     <para>
       PolicyKit provides an authorization API intended to be used by
@@ -17,7 +17,7 @@
     </para>
   </chapter>
 
-  <chapter>
+  <chapter id="polkit-apps">
     <title>Writing PolicyKit applications</title>
     <para>
       PolicyKit applications are privileged mechanisms using the
@@ -46,7 +46,7 @@
     </example>
   </chapter>
 
-  <chapter>
+  <chapter id="polkit-agents">
     <title>Writing PolicyKit Authentication Agents</title>
     <para>
       Authentication agents are provided by desktop environments. When
@@ -70,7 +70,7 @@
     </para>
   </chapter>
 
-  <chapter>
+  <chapter id="polkit-extending">
     <title>Extending PolicyKit</title>
     <para>
       PolicyKit exports a number of extension points to