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

7 files changed, 53 insertions, 46 deletions

diff --git a/docs/adk15ProgGuideDB/annotations.xml b/docs/adk15ProgGuideDB/annotations.xml
index 4094a6e61..a49da8ddd 100644
--- a/docs/adk15ProgGuideDB/annotations.xml
+++ b/docs/adk15ProgGuideDB/annotations.xml
@@ -12,8 +12,8 @@
 		documentation for the Java 5 SDK.
 	</para>
 
-	<sect2>
-		<title>Using Annotations</title>
+	<sect2 id="using-annotations" xreflabel="using-annotations">
+			<title>Using Annotations</title>
 	
 	    <para>
 	      Java 5 introduces <emphasis>annotation types</emphasis> which can
@@ -70,8 +70,8 @@
 		
 	</sect2>
 
-	<sect2>
-	 <title>Retention Policies</title>			
+	<sect2 id="retention-policies" xreflabel="retention-policies">
+		 <title>Retention Policies</title>			
 	 
 	    <para>
 	      Annotations can have one of three retention policies:
@@ -119,8 +119,8 @@
 	    regardless of the retention policy set on the annotation type. See JLS 9.6.1.2.</para>
     </sect2>		
 
-    <sect2>
-    	<title>Accessing Annotations at Runtime</title>
+    <sect2 id="accessing-annotations-at-runtime" xreflabel="accessing-annotations-at-runtime">
+        	<title>Accessing Annotations at Runtime</title>
     	
     	<para>
     		Java 5 supports a new interface, 
@@ -138,7 +138,7 @@
     	
     </sect2>
     
-    <sect2>
+    <sect2 id="annotation-inheritance" xreflabel="annotation-inheritance">
     	<title>Annotation Inheritance</title>
     	
     	<para>
@@ -305,7 +305,7 @@
   	of advice.
   </para>
   	
-  <sect2>
+  <sect2 id="annotation-patterns" xreflabel="annotation-patterns">
     <title>Annotation Patterns</title>
   
       <para>
@@ -402,7 +402,7 @@
     
   </sect2>
   
-  <sect2>
+  <sect2 id="type-patterns" xreflabel="type-patterns">
   	<title>Type Patterns</title>
   	
 	<para>AspectJ 1.5 extends type patterns to allow an optional <literal>AnnotationPattern</literal>
@@ -690,7 +690,7 @@
 
   </sect2>
   
-  <sect2>
+  <sect2 id="example-pointcuts" xreflabel="example-pointcuts">
   	<title>Example Pointcuts</title>
 
    <variablelist>
@@ -763,7 +763,7 @@
 
   </sect2>
 
-   <sect2>
+   <sect2 id="runtime-type-matching-and-context-exposure" xreflabel="runtime-type-matching-and-context-exposure">
   	<title>Runtime type matching and context exposure</title>
 
     <para>AspectJ 5 supports a set of "@" pointcut designators which
@@ -1005,7 +1005,7 @@
     
   </sect2>
 
-  <sect2>
+  <sect2 id="package-and-parameter-annotations" xreflabel="package-and-parameter-annotations">
       <title>Package and Parameter Annotations</title>
 
       <para>
@@ -1133,7 +1133,7 @@
      
   </sect2>
 
-  <sect2>
+  <sect2 id="annotation-inheritance-and-pointcut-matching" xreflabel="annotation-inheritance-and-pointcut-matching">
   	<title>Annotation Inheritance and pointcut matching</title>
   	
   	<para>
@@ -1190,7 +1190,7 @@
   	
   </sect2>
   
-  <sect2>
+  <sect2 id="limitations" xreflabel="limitations">
     <title>Limitations</title>
     <para>
         It would be useful to be able to match join points based on  
@@ -1210,7 +1210,7 @@
   <sect1 id="annotations-decp">
     <title>Using Annotations with declare statements</title>
   
-   <sect2>
+   <sect2 id="declare-error-and-declare-warning" xreflabel="declare-error-and-declare-warning">
   	<title>Declare error and declare warning</title>
   	
   	<para>
@@ -1235,7 +1235,7 @@
   </sect2>
     
   
-  	<sect2>
+  	<sect2 id="declare-parents" xreflabel="declare-parents">
   		<title>declare parents</title>
   
   	<para>
@@ -1288,7 +1288,7 @@
 
   	</sect2>
 
-	<sect2>
+	<sect2 id="declare-precedence" xreflabel="declare-precedence">
 		<title>declare precedence</title>
 
 	<para>
@@ -1410,3 +1410,4 @@
   
 </chapter>
 
+
diff --git a/docs/adk15ProgGuideDB/ataspectj.xml b/docs/adk15ProgGuideDB/ataspectj.xml
index 720d21b61..2836c5e08 100644
--- a/docs/adk15ProgGuideDB/ataspectj.xml
+++ b/docs/adk15ProgGuideDB/ataspectj.xml
@@ -75,7 +75,7 @@
      public aspect Foo perthis(execution(* abc..*(..))) {}
          ]]></programlisting>
 
-    <sect2>
+    <sect2 id="limitations" xreflabel="limitations">
       <title>Limitations</title>
       
        <para>Privileged aspects are not supported by the annotation style.</para>
@@ -105,7 +105,7 @@
             <literal>Around</literal> annotations.
         </para>
 
-        <sect2>
+        <sect2 id="pointcuts" xreflabel="pointcuts">
             <title>Pointcuts</title>
 
             <para>
@@ -307,7 +307,7 @@
 
         </sect2>
 
-        <sect2>
+        <sect2 id="advice" xreflabel="advice">
             <title>Advice</title>
 
             <para>In this section we first discuss the use of annotations for
@@ -831,3 +831,4 @@
     </sect1>
 </chapter>
 
+
diff --git a/docs/adk15ProgGuideDB/generics.xml b/docs/adk15ProgGuideDB/generics.xml
index dcbbd09f2..429f110ec 100644
--- a/docs/adk15ProgGuideDB/generics.xml
+++ b/docs/adk15ProgGuideDB/generics.xml
@@ -14,7 +14,7 @@
 		documentation for the Java 5 SDK.
 	</para>
 
-	<sect2>
+	<sect2 id="declaring-generic-types" xreflabel="declaring-generic-types">
 		<title>Declaring Generic Types</title>
 		
         <para>
@@ -99,7 +99,7 @@
                 
 	</sect2>
 	
-	<sect2>
+	<sect2 id="using-generic-and-parameterized-types" xreflabel="using-generic-and-parameterized-types">
 	    <title>Using Generic and Parameterized Types</title>
 	    
 	    <para>You declare a variable (or a method/constructor argument) of a parameterized type  by specifying a concrete type specfication for each type parameter in
@@ -223,7 +223,7 @@
 	    be a subtype of two interface types which are different parameterizations of the same interface.</para>
 	</sect2>
 	
-	<sect2>
+	<sect2 id="subtypes-supertypes-and-assignability" xreflabel="subtypes-supertypes-and-assignability">
 	    <title>Subtypes, Supertypes, and Assignability</title>
 	    
 	    <para>
@@ -263,7 +263,7 @@
 	    
 	</sect2>
 	
-	<sect2>
+	<sect2 id="generic-methods-and-constructors" xreflabel="generic-methods-and-constructors">
 	    <title>Generic Methods and Constructors</title>
 	    <para>
 	      A static method may be declared with one or more type parameters as in the following declaration:
@@ -290,7 +290,7 @@
 	    	    
 	</sect2>
 	
-	<sect2>
+	<sect2 id="erasure" xreflabel="erasure">
 	  <title>Erasure</title>
 	  <para>Generics in Java are implemented using a technique called <emphasis>erasure</emphasis>. All
 	  type parameter information is erased from the run-time type system. Asking an object of a parameterized
@@ -312,7 +312,7 @@
         also provided for generic <emphasis>abstract</emphasis> aspects.
       </para>
       
-      <sect2>
+      <sect2 id="matching-generic-and-parameterized-types-in-pointcut-expressions" xreflabel="matching-generic-and-parameterized-types-in-pointcut-expressions">
           <title>Matching generic and parameterized types in pointcut expressions</title>
           
           <para>
@@ -899,7 +899,7 @@
   
       </sect2>
       
-      <sect2>
+      <sect2 id="inter-type-declarations" xreflabel="inter-type-declarations">
           <title>Inter-type Declarations</title>
           
           <para>
@@ -996,7 +996,7 @@
       
       </sect2>
  
-      <sect2>
+      <sect2 id="declare-parents" xreflabel="declare-parents">
           <title>Declare Parents</title>
           
           <para>Both generic and parameterized types can be used as the parent type in a <literal>declare parents</literal>
@@ -1020,13 +1020,13 @@
 
       </sect2>
       
-      <sect2>
+      <sect2 id="declare-soft" xreflabel="declare-soft">
           <title>Declare Soft</title>
           <para>It is an error to use a generic or parameterized type as the softened exception type in a declare soft statement. Java 5 does
           not permit a generic class to be a direct or indirect subtype of <literal>Throwable</literal> (JLS 8.1.2).</para>
       </sect2>
 
-      <sect2>
+      <sect2 id="generic-aspects" xreflabel="generic-aspects">
           <title>Generic Aspects</title>
           
           <para><emphasis>This feature will not be fully implemented until AspectJ5 M4.</emphasis></para>
@@ -1302,3 +1302,4 @@
   
 </chapter>
 
+
diff --git a/docs/adk15ProgGuideDB/joinpointsignatures.xml b/docs/adk15ProgGuideDB/joinpointsignatures.xml
index ea702a2f8..377397848 100644
--- a/docs/adk15ProgGuideDB/joinpointsignatures.xml
+++ b/docs/adk15ProgGuideDB/joinpointsignatures.xml
@@ -203,7 +203,7 @@
         <para>The following sections examine signatures for these join points 
         in more detail.</para>
         
-        <sect2>
+        <sect2 id="method-call-join-point-signatures" xreflabel="method-call-join-point-signatures">
             <title>Method call join point signatures</title>
 
         <para>
@@ -276,7 +276,7 @@
         
        </sect2>
       
-      <sect2>
+      <sect2 id="method-execution-join-point-signatures" xreflabel="method-execution-join-point-signatures">
           <title>Method execution join point signatures</title>
           
           <para>Join point signatures for execution join points are defined
@@ -325,7 +325,7 @@
 
       </sect2>
 
-       <sect2>
+       <sect2 id="field-get-and-set-join-point-signatures" xreflabel="field-get-and-set-join-point-signatures">
             <title>Field get and set join point signatures</title>
 
         <para>
@@ -536,3 +536,4 @@
       </sect1>
   
 </chapter>
+
diff --git a/docs/adk15ProgGuideDB/ltw.xml b/docs/adk15ProgGuideDB/ltw.xml
index 6297959a4..5731e4e7b 100644
--- a/docs/adk15ProgGuideDB/ltw.xml
+++ b/docs/adk15ProgGuideDB/ltw.xml
@@ -29,7 +29,7 @@
             classes). AspectJ 5 does not provide explicit support for run-time weaving although
             simple coding patterns can support dynamically enabling and disabling advice in aspects. </para>
         
-        <sect2>
+        <sect2 id="weaving-class-files-more-than-once" xreflabel="weaving-class-files-more-than-once">
             <title>Weaving class files more than once</title>
         
             <para> By default a class file that has been woven by the AspectJ compiler cannot
@@ -72,7 +72,7 @@
         types will be woven. Additional diagnostic options allow the user to debug the configuration and 
         weaving process. </para>
         
-        <sect2>
+        <sect2 id="enabling-load-time-weaving" xreflabel="enabling-load-time-weaving">
             <title>Enabling Load-time Weaving</title>
             <para> AspectJ 5 supports several different ways of enabling load-time weaving for
             an application: agents, a command-line launch script, and a set of interfaces for
@@ -122,7 +122,7 @@
             </variablelist>
         </sect2>
         
-        <sect2>
+        <sect2 id="configuring-load-time-weaving-with-aopxml-files" xreflabel="configuring-load-time-weaving-with-aopxml-files">
             <title>Configuring Load-time Weaving with aop.xml files</title>
             
             <para>The weaver is configured using one or more <literal>META-INF/aop.xml</literal>
@@ -255,7 +255,7 @@
 
         <!-- TODO someone implement that -->
         <!--
-        <sect2>
+        <sect2 id="configuring-load-time-weaving-with-properties-files" xreflabel="configuring-load-time-weaving-with-properties-files">
             <title>Configuring Load-time Weaving with Properties Files</title>
             <para> For memory constrained environments or those without support for XML a simple
                 Java Properties file can be used to configure LTW. Just like XML files,
@@ -273,7 +273,7 @@
         </sect2>
         -->
 
-        <sect2>
+        <sect2 id="weaver-options" xreflabel="weaver-options">
             <title>Weaver Options</title>
             <para> The table below lists the AspectJ options supported by LTW. All other options
                 will be ignored and a warning issued. </para>
@@ -404,7 +404,7 @@
     
     <sect1 id="ltw-agents">
         <title>Supported Agents</title>
-        <sect2>
+        <sect2 id="jvmti" xreflabel="jvmti">
             <title>JVMTI</title>
             <para> When using Java 5 the JVMTI agent can be used by starting the JVM with the
                 following option (adapt according to the path to aspectjweaver.jar): </para>
@@ -412,7 +412,7 @@
 			-javaagent:pathto/aspectjweaver.jar
 		  ]]></programlisting>
         </sect2>
-        <sect2>
+        <sect2 id="jrockit" xreflabel="jrockit">
             <title>JRockit with Java 1.3/1.4 (use JVMTI on Java 5)</title>
             <para> The JRockit agent is configured with the following JVM option: </para>
             <programlisting><![CDATA[
@@ -421,3 +421,4 @@
         </sect2>
     </sect1>
 </chapter>
+
diff --git a/docs/adk15ProgGuideDB/miscellaneous.xml b/docs/adk15ProgGuideDB/miscellaneous.xml
index 24a677cf7..70a630e7d 100644
--- a/docs/adk15ProgGuideDB/miscellaneous.xml
+++ b/docs/adk15ProgGuideDB/miscellaneous.xml
@@ -5,7 +5,7 @@
   <sect1>
       <title>Pointcuts</title>
       
-      <sect2>
+      <sect2 id="binding-of-formals" xreflabel="binding-of-formals">
           <title>Binding of formals</title>
           <para>
            AspectJ 5 is more liberal than AspectJ 1.2.1 in accepting pointcut expressions
@@ -28,7 +28,7 @@
            
       </sect2>
       
-      <sect2>
+      <sect2 id="additional-lint-warnings" xreflabel="additional-lint-warnings">
           <title>Additional lint warnings</title>
           <para>
             Discuss detection of common errors -> warning/error, eg. conjunction of more than one
@@ -95,7 +95,7 @@
    <sect1>
       <title>Tools</title>
       
-      <sect2>
+      <sect2 id="aspectpath" xreflabel="aspectpath">
           <title>Aspectpath</title>
           
           <para>AspectJ 5 allows the specification of directories (containing .class files) on the aspectpath in
@@ -105,3 +105,4 @@
     </sect1>
 </chapter>
 
+
diff --git a/docs/adk15ProgGuideDB/varargs.xml b/docs/adk15ProgGuideDB/varargs.xml
index 38d0fe24d..487a8c01d 100644
--- a/docs/adk15ProgGuideDB/varargs.xml
+++ b/docs/adk15ProgGuideDB/varargs.xml
@@ -21,7 +21,7 @@
             this must always be the last declared argument in the signature.
         </para>
 
-        <sect2>
+        <sect2 id="calling-methods-and-constructors-with-variable-length-arguments" xreflabel="calling-methods-and-constructors-with-variable-length-arguments">
             <title>Calling Methods and Constructors with variable-length arguments</title>
             
             <para>
@@ -71,7 +71,7 @@
         bound as formals in advice.
         </para>
         
-        <sect2>
+        <sect2 id="matching-signatures-based-on-variable-length-argument-types" xreflabel="matching-signatures-based-on-variable-length-argument-types">
             <title>Matching signatures based on variable length argument types</title>
             
             <para>
@@ -155,7 +155,7 @@
                
         </sect2>
         
-        <sect2>
+        <sect2 id="exposing-variable-length-arguments-as-context-in-pointcuts-and-advice" xreflabel="exposing-variable-length-arguments-as-context-in-pointcuts-and-advice">
             <title>Exposing variable-length arguments as context in pointcuts and advice</title>
             
             <para>
@@ -206,3 +206,4 @@
   
 </chapter>
 
+