ensure every section has an assigned id so that urls in generated html remain stable across builds.

5 files changed, 59 insertions, 54 deletions

diff --git a/docs/progGuideDB/examples.xml b/docs/progGuideDB/examples.xml
index 762a4ef08..12c6d1ccc 100644
--- a/docs/progGuideDB/examples.xml
+++ b/docs/progGuideDB/examples.xml
@@ -620,7 +620,7 @@ public aspect HashablePoint {
   <sect1 id="examples-development">
     <title>Development Aspects</title>
 
-    <sect2>
+    <sect2 id="tracing-using-aspects" xreflabel="tracing-using-aspects">
       <title>Tracing using aspects</title>
 
       <para>
@@ -1086,7 +1086,7 @@ abstract aspect Trace {
 
     <!--  ==================== -->
 
-    <sect2><!-- A Bean Aspect -->
+    <sect2 id="a-bean-aspect" xreflabel="a-bean-aspect"><!-- A Bean Aspect -->
       <title>A Bean Aspect</title>
 
       <para>
@@ -1367,7 +1367,7 @@ java bean.Demo
 
     <!--  ==================== -->
 
-    <sect2>
+    <sect2 id="the-subject-observer-protocol" xreflabel="the-subject-observer-protocol">
       <title>The Subject/Observer Protocol</title>
 
       <para>
@@ -1607,7 +1607,7 @@ aspect SubjectObserverProtocolImpl extends SubjectObserverProtocol {
 
     <!--  ==================== -->
 
-    <sect2>
+    <sect2 id="a-simple-telecom-simulation" xreflabel="a-simple-telecom-simulation">
       <title>A Simple Telecom Simulation</title>
 
       <para>
@@ -2166,7 +2166,7 @@ public aspect Billing {
   <sect1 id="examples-reusable">
     <title>Reusable Aspects</title>
 
-    <sect2>
+    <sect2 id="tracing-using-aspects-revisited" xreflabel="tracing-using-aspects-revisited">
       <title>Tracing using Aspects, Revisited</title>
 
       <para>
@@ -2436,3 +2436,4 @@ s1.toString(): Square side = 1.0 @ (1.0, 2.0)
     </sect2>
   </sect1>
 </chapter>
+
diff --git a/docs/progGuideDB/gettingstarted.xml b/docs/progGuideDB/gettingstarted.xml
index c9ac6ad36..e81db668f 100644
--- a/docs/progGuideDB/gettingstarted.xml
+++ b/docs/progGuideDB/gettingstarted.xml
@@ -183,7 +183,7 @@
 
 <!-- ============================== -->
 
-    <sect2>
+    <sect2 id="the-dynamic-join-point-model" xreflabel="the-dynamic-join-point-model">
       <title>The Dynamic Join Point Model</title>
 
       <para>
@@ -217,7 +217,7 @@
 
 <!-- ============================== -->
 
-    <sect2>
+    <sect2 id="pointcuts" xreflabel="pointcuts">
       <title>Pointcuts</title>
 
       <para>
@@ -350,7 +350,7 @@ cflow(move())
 
 <!-- ============================== -->
 
-    <sect2>
+    <sect2 id="advice" xreflabel="advice">
       <title>Advice</title>
 
       <para>
@@ -501,7 +501,7 @@ after(FigureElement fe, int x, int y) returning: setXY(fe, x, y) {
 
 <!-- ============================== -->
 
-    <sect2>
+    <sect2 id="inter-type-declarations" xreflabel="inter-type-declarations">
       <title>Inter-type declarations</title>
 
       <para>
@@ -612,7 +612,7 @@ aspect PointObserving {
 
 <!-- ============================== -->
 
-    <sect2>
+    <sect2 id="aspects" xreflabel="aspects">
       <title>Aspects</title>
 
       <para>
@@ -674,7 +674,7 @@ aspect Logging {
       possible to easily enable and disable the functionality when desired.
     </para>
 
-    <sect2>
+    <sect2 id="tracing" xreflabel="tracing">
       <title>Tracing</title>
 
       <para>
@@ -744,7 +744,7 @@ Entering: call(void FigureElement.draw(GraphicsContext))
       </para>
     </sect2>
 
-    <sect2>
+    <sect2 id="profiling-and-logging" xreflabel="profiling-and-logging">
       <title>Profiling and Logging</title>
 
       <para>
@@ -807,7 +807,7 @@ aspect SetsInRotateCounting {
 
 <!-- ============================== -->
 
-    <sect2>
+    <sect2 id="pre-and-post-conditions" xreflabel="pre-and-post-conditions">
       <title>Pre- and Post-Conditions</title>
 
       <para>
@@ -873,7 +873,7 @@ aspect PointBoundsChecking {
 
 <!-- ============================== -->
 
-    <sect2>
+    <sect2 id="contract-enforcement" xreflabel="contract-enforcement">
       <title>Contract Enforcement</title>
 
       <para>
@@ -944,7 +944,7 @@ aspect RegistrationProtection {
 
 <!-- ============================== -->
 
-    <sect2>
+    <sect2 id="configuration-management" xreflabel="configuration-management">
       <title>Configuration Management</title>
 
       <para>
@@ -984,7 +984,7 @@ aspect RegistrationProtection {
         maintain.
       </para>
 
-    <sect2>
+    <sect2 id="change-monitoring" xreflabel="change-monitoring">
       <title>Change Monitoring</title>
 
       <para>
@@ -1098,7 +1098,7 @@ aspect MoveTracking {
 
 <!-- ============================== -->
 
-    <sect2>
+    <sect2 id="context-passing" xreflabel="context-passing">
       <title>Context Passing</title>
 
       <para>
@@ -1308,3 +1308,4 @@ aspect ContextFilling {
     </para>
   </sect1>
 </chapter>
+
diff --git a/docs/progGuideDB/implementation.xml b/docs/progGuideDB/implementation.xml
index d654eb44e..f83e7dd8c 100644
--- a/docs/progGuideDB/implementation.xml
+++ b/docs/progGuideDB/implementation.xml
@@ -148,7 +148,7 @@
 <sect1>
   <title>Bytecode Notes</title>
 
-  <sect2>
+  <sect2 id="the-class-expression-and-string" xreflabel="the-class-expression-and-string">
     <title>The .class expression and String +</title>
 
     <para> The java language form <literal>Foo.class</literal> is
@@ -186,7 +186,7 @@
 
   </sect2>
 
-  <sect2>
+  <sect2 id="the-handler-join-point" xreflabel="the-handler-join-point">
     <title>The Handler join point</title>
 
 
@@ -249,7 +249,7 @@
 
   </sect2>
 
-  <sect2>
+  <sect2 id="initializers-and-inter-type-constructors" xreflabel="initializers-and-inter-type-constructors">
     <title>Initializers and Inter-type Constructors</title>
 
   <para>
@@ -358,3 +358,4 @@
 </appendix>
 
 
+
diff --git a/docs/progGuideDB/language.xml b/docs/progGuideDB/language.xml
index e337d79ec..29b6dcfb9 100644
--- a/docs/progGuideDB/language.xml
+++ b/docs/progGuideDB/language.xml
@@ -31,7 +31,7 @@
       be exposed to the new terminology introduced by AspectJ.
     </para>
 
-    <sect2>
+    <sect2 id="an-example-aspect" xreflabel="an-example-aspect">
       <title>An Example Aspect</title>
 
       <para>
@@ -81,7 +81,7 @@
       </para>
     </sect2>
 
-    <sect2>
+    <sect2 id="pointcuts" xreflabel="pointcuts">
       <title>Pointcuts</title>
 
       <para>
@@ -149,7 +149,7 @@ pointcut services(Server s): target(s) && call(public * *(..))
 
 <!-- ============================== -->
 
-    <sect2>
+    <sect2 id="advice" xreflabel="advice">
       <title>Advice</title>
 
       <para>
@@ -291,7 +291,7 @@ pointcut ioHandler(): within(MyClass) && handler(IOException);
       happen).  The right-hand side consists of the pointcut itself.
     </para>
 
-    <sect2>
+    <sect2 id="some-example-pointcuts" xreflabel="some-example-pointcuts">
       <title>Some Example Pointcuts</title>
 
       <para>
@@ -549,7 +549,7 @@ interface MyInterface { ... }
       </itemizedlist>
     </sect2>
 
-    <sect2>
+    <sect2 id="call-vs-execution" xreflabel="call-vs-execution">
       <title>call vs. execution</title>
 
       <para>
@@ -601,7 +601,7 @@ interface MyInterface { ... }
 
 <!-- ============================== -->
 
-    <sect2>
+    <sect2 id="pointcut-composition" xreflabel="pointcut-composition">
       <title>Pointcut composition</title>
 
       <para>
@@ -724,7 +724,7 @@ aspect A  {
 
 <!-- ============================== -->
 
-    <sect2>
+    <sect2 id="pointcut-parameters" xreflabel="pointcut-parameters">
       <title>Pointcut Parameters</title>
 
       <para>
@@ -841,7 +841,7 @@ pointcut setter(Point p, int newval): target(p) &&
 
 <!-- ============================== -->
 
-    <sect2>
+    <sect2 id="example" xreflabel="example">
       <title>Example: <literal>HandleLiveness</literal></title>
 
       <para>
@@ -1139,7 +1139,7 @@ void around(Point p, int x): target(p)
 
 <!-- ============================== -->
 
-    <sect2>
+    <sect2 id="inter-type-scope" xreflabel="inter-type-scope">
       <title>Inter-type Scope</title>
 
       <para>
@@ -1169,7 +1169,7 @@ void around(Point p, int x): target(p)
 
 <!-- ============================== -->
 
-    <sect2>
+    <sect2 id="example-pointassertions" xreflabel="example-pointassertions">
       <title>Example: <literal>PointAssertions</literal></title>
 
       <para>
@@ -1307,3 +1307,4 @@ void around(Point p, int x): target(p)
 
   </sect1>
 </chapter>
+
diff --git a/docs/progGuideDB/semantics.xml b/docs/progGuideDB/semantics.xml
index cf5740fde..fe4d11322 100644
--- a/docs/progGuideDB/semantics.xml
+++ b/docs/progGuideDB/semantics.xml
@@ -544,7 +544,7 @@
       </varlistentry>
     </variablelist>
 
-    <sect2>
+    <sect2 id="pointcut-definition" xreflabel="pointcut-definition">
       <title>Pointcut definition</title>
 
       <para>
@@ -625,7 +625,7 @@
 </programlisting>
     </sect2>
 
-    <sect2>
+    <sect2 id="context-exposure" xreflabel="context-exposure">
       <title>Context exposure</title>
 
       <para>
@@ -736,7 +736,7 @@
 
     </sect2>
 
-    <sect2>
+    <sect2 id="primitive-pointcuts" xreflabel="primitive-pointcuts">
       <title>Primitive pointcuts</title>
 
       <sect3>
@@ -1089,7 +1089,7 @@ aspect A {
       </sect3>
     </sect2>
 
-    <sect2>
+    <sect2 id="signatures" xreflabel="signatures">
       <title>Signatures</title>
 
       <para>
@@ -1180,7 +1180,7 @@ aspect A {
 
 <!-- ============================== -->
 
-    <sect2>
+    <sect2 id="matching" xreflabel="matching">
       <title>Matching</title>
 
       <para>
@@ -1503,7 +1503,7 @@ aspect A {
       </sect3>
     </sect2>
 
-    <sect2>
+    <sect2 id="type-patterns" xreflabel="type-patterns">
       <title>Type patterns</title>
 
       <para>
@@ -1705,7 +1705,7 @@ aspect A {
       </sect3>
     </sect2>
 
-    <sect2>
+    <sect2 id="pattern-summary" xreflabel="pattern-summary">
       <title>Pattern Summary</title>
 
       <para>
@@ -1974,7 +1974,7 @@ ModifiersPattern =
       advice.
     </para>
 
-    <sect2>
+    <sect2 id="advice-modifiers" xreflabel="advice-modifiers">
       <title>Advice modifiers</title>
 
       <para>
@@ -1984,7 +1984,7 @@ ModifiersPattern =
       </para>
     </sect2>
 
-    <sect2>
+    <sect2 id="advice-and-checked-exceptions" xreflabel="advice-and-checked-exceptions">
       <title>Advice and checked exceptions</title>
 
       <para>
@@ -2083,7 +2083,7 @@ ModifiersPattern =
 
     </sect2>
 
-    <sect2>
+    <sect2 id="advice-precedence" xreflabel="advice-precedence">
       <title>Advice precedence</title>
 
       <para>
@@ -2185,7 +2185,7 @@ ModifiersPattern =
       </sect3>
     </sect2>
 
-    <sect2>
+    <sect2 id="reflective-access-to-the-join-point" xreflabel="reflective-access-to-the-join-point">
       <title>Reflective access to the join point</title>
 
       <para>
@@ -2255,7 +2255,7 @@ ModifiersPattern =
       inter-type member declarations and other <literal>declare</literal> forms.
     </para>
 
-    <sect2>
+    <sect2 id="inter-type-member-declarations" xreflabel="inter-type-member-declarations">
       <title>Inter-type member declarations</title>
 
         <para>
@@ -2383,7 +2383,7 @@ ModifiersPattern =
         declaration.
       </para>
 
-    <sect2>
+    <sect2 id="access-modifiers" xreflabel="access-modifiers">
       <title>Access modifiers</title>
 
       <para>
@@ -2424,7 +2424,7 @@ ModifiersPattern =
       </para>
     </sect2>
 
-    <sect2>
+    <sect2 id="conflicts" xreflabel="conflicts">
       <title>Conflicts</title>
 
       <para>
@@ -2511,7 +2511,7 @@ ModifiersPattern =
 
     </sect2>
 
-    <sect2>
+    <sect2 id="extension-and-implementation" xreflabel="extension-and-implementation">
       <title>Extension and Implementation</title>
 
       <para>
@@ -2543,7 +2543,7 @@ ModifiersPattern =
 
     </sect2>
 
-    <sect2>
+    <sect2 id="interfaces-with-members" xreflabel="interfaces-with-members">
       <title>Interfaces with members</title>
 
       <para>
@@ -2589,7 +2589,7 @@ ModifiersPattern =
 
 <!-- ============================== -->
 
-    <sect2>
+    <sect2 id="warnings-and-errors" xreflabel="warnings-and-errors">
       <title>Warnings and Errors</title>
 
       <para>An aspect may specify that a particular join point should never be
@@ -2607,7 +2607,7 @@ ModifiersPattern =
 
     </sect2>
 
-    <sect2>
+    <sect2 id="softened-exceptions" xreflabel="softened-exceptions">
       <title>Softened exceptions</title>
 
       <para>An aspect may specify that a particular kind of exception, if
@@ -2669,7 +2669,7 @@ ModifiersPattern =
 
     </sect2>
 
-    <sect2>
+    <sect2 id="advice-precedence" xreflabel="advice-precedence">
       <title>Advice Precedence</title>
 
       <para>
@@ -2823,7 +2823,7 @@ ModifiersPattern =
     </sect2>
 
 
-    <sect2>
+    <sect2 id="statically-determinable-pointcuts" xreflabel="statically-determinable-pointcuts">
       <title>Statically determinable pointcuts</title>
 
       <para>Pointcuts that appear inside of <literal>declare</literal> forms
@@ -2856,7 +2856,7 @@ ModifiersPattern =
       declaration. 
     </para>
 
-    <sect2>
+    <sect2 id="aspect-declaration" xreflabel="aspect-declaration">
       <title>Aspect Declaration</title>
 
       <para>
@@ -2902,7 +2902,7 @@ ModifiersPattern =
       </sect3> 
     </sect2>
 
-    <sect2>
+    <sect2 id="aspect-extension" xreflabel="aspect-extension">
       <title>Aspect Extension</title>
 
       <para>
@@ -2942,7 +2942,7 @@ ModifiersPattern =
       </sect3>
     </sect2>
 
-    <sect2>
+    <sect2 id="aspect-instantiation" xreflabel="aspect-instantiation">
       <title>Aspect instantiation</title>
 
       <para>
@@ -3106,7 +3106,7 @@ ModifiersPattern =
       </sect3>
     </sect2>
 
-    <sect2>
+    <sect2 id="aspect-privilege" xreflabel="aspect-privilege">
       <title>Aspect privilege</title>
 
       <itemizedlist>
@@ -3183,3 +3183,4 @@ ModifiersPattern =
 </appendix>
 
 
+