From dacc4a64296930ed31520f76a3d5068794733830 Mon Sep 17 00:00:00 2001
From: Simon Brooke <simon@journeyman.cc>
Date: Sun, 18 Mar 2018 13:28:07 +0000
Subject: [PATCH] Tidied up documentation file a bit (not yet sufficiently)

---
 adl_user_doc.html         | 695 ++++++++++----------------------------
 documentation.css         | 192 +++++++++--
 remove-edit-sections.xslt |  16 +
 schemas/adl-1.4.dtd       | 276 +++++++--------
 4 files changed, 484 insertions(+), 695 deletions(-)
 mode change 100755 => 100644 adl_user_doc.html
 create mode 100644 remove-edit-sections.xslt
diff --git a/adl_user_doc.html b/adl_user_doc.html
old mode 100755
new mode 100644
index 77bc4bd..4623543
--- a/adl_user_doc.html
+++ b/adl_user_doc.html
@@ -20,8 +20,7 @@
   <!--	======================================================	-->
 
   <title>Application Description Language framework</title>
-  <link href="/styles/journeyman.css" rel="stylesheet" type=
-  "text/css" />
+  <link href="documentation.css" rel="stylesheet" type="text/css"/>
 </head>
 
 <body>
@@ -40,210 +39,122 @@
             </div>
 
             <ul>
-              <li class="toclevel-1"><a href=
-              "#What_is_Application_Description_Language.3F"><span class="tocnumber">
+              <li class="toclevel-1"><a href="#What_is_Application_Description_Language.3F"><span class="tocnumber">
               1</span> <span class="toctext">What is Application
               Description Language?</span></a></li>
 
-              <li class="toclevel-1"><a href=
-              "#Current_versions"><span class="tocnumber">2</span>
+              <li class="toclevel-1"><a href="#Current_versions"><span class="tocnumber">2</span>
               <span class="toctext">Current
               versions</span></a></li>
 
-              <li class="toclevel-1"><a href=
-              "#What_is_the_Application_Description_Language_Framework.3F">
-              <span class="tocnumber">3</span> <span class=
-              "toctext">What is the Application Description
+              <li class="toclevel-1"><a href="#What_is_the_Application_Description_Language_Framework.3F">
+              <span class="tocnumber">3</span> <span class="toctext">What is the Application Description
               Language Framework?</span></a></li>
 
               <li class="toclevel-1">
-                <a href="#Why_does_it_matter.3F"><span class=
-                "tocnumber">4</span> <span class="toctext">Why does
+                <a href="#Why_does_it_matter.3F"><span class="tocnumber">4</span> <span class="toctext">Why does
                 it matter?</span></a>
 
                 <ul>
-                  <li class="toclevel-2"><a href=
-                  "#Automated_Application_Generation"><span class=
-                  "tocnumber">4.1</span> <span class=
-                  "toctext">Automated Application
+                  <li class="toclevel-2"><a href="#Automated_Application_Generation"><span class="tocnumber">4.1</span> <span class="toctext">Automated Application
                   Generation</span></a></li>
 
-                  <li class="toclevel-2"><a href=
-                  "#Integration_with_hand-written_code"><span class="tocnumber">
+                  <li class="toclevel-2"><a href="#Integration_with_hand-written_code"><span class="tocnumber">
                   4.2</span> <span class="toctext">Integration with
                   hand-written code</span></a></li>
 
-                  <li class="toclevel-2"><a href=
-                  "#High_quality_auto-generated_code"><span class=
-                  "tocnumber">4.3</span> <span class="toctext">High
+                  <li class="toclevel-2"><a href="#High_quality_auto-generated_code"><span class="tocnumber">4.3</span> <span class="toctext">High
                   quality auto-generated code</span></a></li>
                 </ul>
               </li>
 
               <li class="toclevel-1">
-                <a href=
-                "#What_can_the_Application_Description_Language_framework_now_do.3F">
-                <span class="tocnumber">5</span> <span class=
-                "toctext">What can the Application Description
+                <a href="#What_can_the_Application_Description_Language_framework_now_do.3F">
+                <span class="tocnumber">5</span> <span class="toctext">What can the Application Description
                 Language framework now do?</span></a>
 
                 <ul>
-                  <li class="toclevel-2"><a href=
-                  "#adl2entityclass.xsl"><span class=
-                  "tocnumber">5.1</span> <span class=
-                  "toctext">adl2entityclass.xsl</span></a></li>
+                  <li class="toclevel-2"><a href="#adl2entityclass.xsl"><span class="tocnumber">5.1</span> <span class="toctext">adl2entityclass.xsl</span></a></li>
 
-                  <li class="toclevel-2"><a href=
-                  "#adl2mssql.xsl"><span class=
-                  "tocnumber">5.2</span> <span class=
-                  "toctext">adl2mssql.xsl</span></a></li>
+                  <li class="toclevel-2"><a href="#adl2mssql.xsl"><span class="tocnumber">5.2</span> <span class="toctext">adl2mssql.xsl</span></a></li>
 
-                  <li class="toclevel-2"><a href=
-                  "#adl2views.xsl"><span class=
-                  "tocnumber">5.3</span> <span class=
-                  "toctext">adl2views.xsl</span></a></li>
+                  <li class="toclevel-2"><a href="#adl2views.xsl"><span class="tocnumber">5.3</span> <span class="toctext">adl2views.xsl</span></a></li>
 
-                  <li class="toclevel-2"><a href=
-                  "#adl2controllerclasses.xsl"><span class=
-                  "tocnumber">5.4</span> <span class=
-                  "toctext">adl2controllerclasses.xsl</span></a></li>
+                  <li class="toclevel-2"><a href="#adl2controllerclasses.xsl"><span class="tocnumber">5.4</span> <span class="toctext">adl2controllerclasses.xsl</span></a></li>
 
-                  <li class="toclevel-2"><a href=
-                  "#adl2hibernate.xsl"><span class=
-                  "tocnumber">5.5</span> <span class=
-                  "toctext">adl2hibernate.xsl</span></a></li>
+                  <li class="toclevel-2"><a href="#adl2hibernate.xsl"><span class="tocnumber">5.5</span> <span class="toctext">adl2hibernate.xsl</span></a></li>
 
-                  <li class="toclevel-2"><a href=
-                  "#adl2pgsql.xsl"><span class=
-                  "tocnumber">5.6</span> <span class=
-                  "toctext">adl2pgsql.xsl</span></a></li>
+                  <li class="toclevel-2"><a href="#adl2pgsql.xsl"><span class="tocnumber">5.6</span> <span class="toctext">adl2pgsql.xsl</span></a></li>
                 </ul>
               </li>
 
-              <li class="toclevel-1"><a href=
-              "#So_is_ADL_a_quick_way_to_build_Monorail_applications.3F">
-              <span class="tocnumber">6</span> <span class=
-              "toctext">So is ADL a quick way to build Monorail
+              <li class="toclevel-1"><a href="#So_is_ADL_a_quick_way_to_build_Monorail_applications.3F">
+              <span class="tocnumber">6</span> <span class="toctext">So is ADL a quick way to build Monorail
               applications?</span></a></li>
 
               <li class="toclevel-1">
-                <a href="#Limitations_on_ADL"><span class=
-                "tocnumber">7</span> <span class=
-                "toctext">Limitations on ADL</span></a>
+                <a href="#Limitations_on_ADL"><span class="tocnumber">7</span> <span class="toctext">Limitations on ADL</span></a>
 
                 <ul>
                   <li class="toclevel-2">
-                    <a href="#Current_limitations"><span class=
-                    "tocnumber">7.1</span> <span class=
-                    "toctext">Current limitations</span></a>
+                    <a href="#Current_limitations"><span class="tocnumber">7.1</span> <span class="toctext">Current limitations</span></a>
 
                     <ul>
-                      <li class="toclevel-3"><a href=
-                      "#Authentication_model"><span class=
-                      "tocnumber">7.1.1</span> <span class=
-                      "toctext">Authentication
+                      <li class="toclevel-3"><a href="#Authentication_model"><span class="tocnumber">7.1.1</span> <span class="toctext">Authentication
                       model</span></a></li>
 
-                      <li class="toclevel-3"><a href=
-                      "#Alternative_Verbs"><span class=
-                      "tocnumber">7.1.2</span> <span class=
-                      "toctext">Alternative Verbs</span></a></li>
+                      <li class="toclevel-3"><a href="#Alternative_Verbs"><span class="tocnumber">7.1.2</span> <span class="toctext">Alternative Verbs</span></a></li>
                     </ul>
                   </li>
 
-                  <li class="toclevel-2"><a href=
-                  "#Inherent_limitations"><span class=
-                  "tocnumber">7.2</span> <span class=
-                  "toctext">Inherent limitations</span></a></li>
+                  <li class="toclevel-2"><a href="#Inherent_limitations"><span class="tocnumber">7.2</span> <span class="toctext">Inherent limitations</span></a></li>
                 </ul>
               </li>
 
               <li class="toclevel-1">
-                <a href="#ADL_Vocabulary"><span class=
-                "tocnumber">8</span> <span class="toctext">ADL
+                <a href="#ADL_Vocabulary"><span class="tocnumber">8</span> <span class="toctext">ADL
                 Vocabulary</span></a>
 
                 <ul>
                   <li class="toclevel-2">
-                    <a href="#Basic_definitions"><span class=
-                    "tocnumber">8.1</span> <span class=
-                    "toctext">Basic definitions</span></a>
+                    <a href="#Basic_definitions"><span class="tocnumber">8.1</span> <span class="toctext">Basic definitions</span></a>
 
                     <ul>
-                      <li class="toclevel-3"><a href=
-                      "#Permissions"><span class=
-                      "tocnumber">8.1.1</span> <span class=
-                      "toctext">Permissions</span></a></li>
+                      <li class="toclevel-3"><a href="#Permissions"><span class="tocnumber">8.1.1</span> <span class="toctext">Permissions</span></a></li>
 
-                      <li class="toclevel-3"><a href=
-                      "#Data_types"><span class=
-                      "tocnumber">8.1.2</span> <span class=
-                      "toctext">Data types</span></a></li>
+                      <li class="toclevel-3"><a href="#Data_types"><span class="tocnumber">8.1.2</span> <span class="toctext">Data types</span></a></li>
 
-                      <li class="toclevel-3"><a href=
-                      "#Definable_data_types"><span class=
-                      "tocnumber">8.1.3</span> <span class=
-                      "toctext">Definable data
+                      <li class="toclevel-3"><a href="#Definable_data_types"><span class="tocnumber">8.1.3</span> <span class="toctext">Definable data
                       types</span></a></li>
 
-                      <li class="toclevel-3"><a href=
-                      "#Page_content"><span class=
-                      "tocnumber">8.1.4</span> <span class=
-                      "toctext">Page content</span></a></li>
+                      <li class="toclevel-3"><a href="#Page_content"><span class="tocnumber">8.1.4</span> <span class="toctext">Page content</span></a></li>
                     </ul>
                   </li>
 
                   <li class="toclevel-2">
-                    <a href="#The_Elements"><span class=
-                    "tocnumber">8.2</span> <span class=
-                    "toctext">The Elements</span></a>
+                    <a href="#The_Elements"><span class="tocnumber">8.2</span> <span class="toctext">The Elements</span></a>
 
                     <ul>
-                      <li class="toclevel-3"><a href=
-                      "#Application"><span class=
-                      "tocnumber">8.2.1</span> <span class=
-                      "toctext">Application</span></a></li>
+                      <li class="toclevel-3"><a href="#Application"><span class="tocnumber">8.2.1</span> <span class="toctext">Application</span></a></li>
 
-                      <li class="toclevel-3"><a href=
-                      "#Definition"><span class=
-                      "tocnumber">8.2.2</span> <span class=
-                      "toctext">Definition</span></a></li>
+                      <li class="toclevel-3"><a href="#Definition"><span class="tocnumber">8.2.2</span> <span class="toctext">Definition</span></a></li>
 
-                      <li class="toclevel-3"><a href=
-                      "#Groups"><span class=
-                      "tocnumber">8.2.3</span> <span class=
-                      "toctext">Groups</span></a></li>
+                      <li class="toclevel-3"><a href="#Groups"><span class="tocnumber">8.2.3</span> <span class="toctext">Groups</span></a></li>
 
-                      <li class="toclevel-3"><a href=
-                      "#Enities_and_Properties"><span class=
-                      "tocnumber">8.2.4</span> <span class=
-                      "toctext">Enities and
+                      <li class="toclevel-3"><a href="#Enities_and_Properties"><span class="tocnumber">8.2.4</span> <span class="toctext">Enities and
                       Properties</span></a></li>
 
-                      <li class="toclevel-3"><a href=
-                      "#Options"><span class=
-                      "tocnumber">8.2.5</span> <span class=
-                      "toctext">Options</span></a></li>
+                      <li class="toclevel-3"><a href="#Options"><span class="tocnumber">8.2.5</span> <span class="toctext">Options</span></a></li>
 
-                      <li class="toclevel-3"><a href=
-                      "#Permissions_2"><span class=
-                      "tocnumber">8.2.6</span> <span class=
-                      "toctext">Permissions</span></a></li>
+                      <li class="toclevel-3"><a href="#Permissions_2"><span class="tocnumber">8.2.6</span> <span class="toctext">Permissions</span></a></li>
 
-                      <li class="toclevel-3"><a href=
-                      "#Pragmas"><span class=
-                      "tocnumber">8.2.7</span> <span class=
-                      "toctext">Pragmas</span></a></li>
+                      <li class="toclevel-3"><a href="#Pragmas"><span class="tocnumber">8.2.7</span> <span class="toctext">Pragmas</span></a></li>
 
-                      <li class="toclevel-3"><a href=
-                      "#Prompts.2C_helptexts_and_error_texts"><span class="tocnumber">
+                      <li class="toclevel-3"><a href="#Prompts.2C_helptexts_and_error_texts"><span class="tocnumber">
                       8.2.8</span> <span class="toctext">Prompts,
                       helptexts and error texts</span></a></li>
 
-                      <li class="toclevel-3"><a href=
-                      "#Forms.2C_Pages_and_Lists"><span class=
-                      "tocnumber">8.2.9</span> <span class=
-                      "toctext">Forms, Pages and
+                      <li class="toclevel-3"><a href="#Forms.2C_Pages_and_Lists"><span class="tocnumber">8.2.9</span> <span class="toctext">Forms, Pages and
                       Lists</span></a></li>
                     </ul>
                   </li>
@@ -251,58 +162,36 @@
               </li>
 
               <li class="toclevel-1">
-                <a href="#Using_ADL_in_your_project"><span class=
-                "tocnumber">9</span> <span class="toctext">Using
+                <a href="#Using_ADL_in_your_project"><span class="tocnumber">9</span> <span class="toctext">Using
                 ADL in your project</span></a>
 
                 <ul>
-                  <li class="toclevel-2"><a href=
-                  "#Selecting_the_version"><span class=
-                  "tocnumber">9.1</span> <span class=
-                  "toctext">Selecting the version</span></a></li>
+                  <li class="toclevel-2"><a href="#Selecting_the_version"><span class="tocnumber">9.1</span> <span class="toctext">Selecting the version</span></a></li>
 
                   <li class="toclevel-2">
-                    <a href=
-                    "#Integrating_into_your_build"><span class=
-                    "tocnumber">9.2</span> <span class=
-                    "toctext">Integrating into your
+                    <a href="#Integrating_into_your_build"><span class="tocnumber">9.2</span> <span class="toctext">Integrating into your
                     build</span></a>
 
                     <ul>
-                      <li class="toclevel-3"><a href=
-                      "#Properties"><span class=
-                      "tocnumber">9.2.1</span> <span class=
-                      "toctext">Properties</span></a></li>
+                      <li class="toclevel-3"><a href="#Properties"><span class="tocnumber">9.2.1</span> <span class="toctext">Properties</span></a></li>
 
-                      <li class="toclevel-3"><a href=
-                      "#Canonicalisation"><span class=
-                      "tocnumber">9.2.2</span> <span class=
-                      "toctext">Canonicalisation</span></a></li>
+                      <li class="toclevel-3"><a href="#Canonicalisation"><span class="tocnumber">9.2.2</span> <span class="toctext">Canonicalisation</span></a></li>
 
-                      <li class="toclevel-3"><a href=
-                      "#Generate_NHibernate_mapping"><span class=
-                      "tocnumber">9.2.3</span> <span class=
-                      "toctext">Generate NHibernate
+                      <li class="toclevel-3"><a href="#Generate_NHibernate_mapping"><span class="tocnumber">9.2.3</span> <span class="toctext">Generate NHibernate
                       mapping</span></a></li>
 
-                      <li class="toclevel-3"><a href=
-                      "#Generate_SQL"><span class=
-                      "tocnumber">9.2.4</span> <span class=
-                      "toctext">Generate SQL</span></a></li>
+                      <li class="toclevel-3"><a href="#Generate_SQL"><span class="tocnumber">9.2.4</span> <span class="toctext">Generate SQL</span></a></li>
 
-                      <li class="toclevel-3"><a href=
-                      "#Generate_C.23_entity_classes_.28.27POCOs.27.29">
+                      <li class="toclevel-3"><a href="#Generate_C.23_entity_classes_.28.27POCOs.27.29">
                       <span class="tocnumber">9.2.5</span>
                       <span class="toctext">Generate C# entity
                       classes ('POCOs')</span></a></li>
 
-                      <li class="toclevel-3"><a href=
-                      "#Generate_Monorail_controller_classes"><span class="tocnumber">
+                      <li class="toclevel-3"><a href="#Generate_Monorail_controller_classes"><span class="tocnumber">
                       9.2.6</span> <span class="toctext">Generate
                       Monorail controller classes</span></a></li>
 
-                      <li class="toclevel-3"><a href=
-                      "#Generate_Velocity_views_for_use_with_Monorail">
+                      <li class="toclevel-3"><a href="#Generate_Velocity_views_for_use_with_Monorail">
                       <span class="tocnumber">9.2.7</span>
                       <span class="toctext">Generate Velocity views
                       for use with Monorail</span></a></li>
@@ -315,25 +204,17 @@
         </tr>
       </tbody>
     </table><script type="text/javascript">
-//<![CDATA[
+//
     if (window.showTocToggle) { var tocShowText = "show"; var tocHideText = "hide"; showTocToggle(); } 
-    //]]>
-    </script> <a name="What_is_Application_Description_Language.3F"
-    id="What_is_Application_Description_Language.3F"></a>
+    //
+    </script> <a name="What_is_Application_Description_Language.3F" id="What_is_Application_Description_Language.3F"/>
 
-    <h2><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=1"
-    title=
-    "Edit section: What is Application Description Language?">edit</a>]</span>
+    <h2>
     <span class="mw-headline">What is Application Description
     Language?</span></h2>
 
     <p>Application Description Language is an XML vocabulary,
-    defined in a <a href=
-    "http://en.wikipedia.org/wiki/Document_Type_Definition" class=
-    "external text" title=
-    "http://en.wikipedia.org/wiki/Document_Type_Definition" rel=
-    "nofollow">Document Type Definition</a>, which declaratively
+    defined in a <a href="http://en.wikipedia.org/wiki/Document_Type_Definition" class="external text" title="http://en.wikipedia.org/wiki/Document_Type_Definition" rel="nofollow">Document Type Definition</a>, which declaratively
     describes the entities in an application domain, their
     relationships, and their properties. Because ADL is defined in
     a formal definition which can be parsed by XML editors, any
@@ -344,94 +225,50 @@
     Schema, since it is desirable to be able to mix HTML in with
     ADL in the same document.</p>
 
-    <p>ADL is thus a '<a href=
-    "http://en.wikipedia.org/wiki/Fourth-generation_programming_language"
-    class="external text" title=
-    "http://en.wikipedia.org/wiki/Fourth-generation_programming_language"
-    rel="nofollow">Fourth Generation Language</a>' as understood in
+    <p>ADL is thus a '<a href="http://en.wikipedia.org/wiki/Fourth-generation_programming_language" class="external text" title="http://en.wikipedia.org/wiki/Fourth-generation_programming_language" rel="nofollow">Fourth Generation Language</a>' as understood in
     the 1980s - an ultra-high level language for a specific problem
-    domain; but it is a purely declarative 4GL.</p><a name=
-    "Current_versions" id="Current_versions"></a>
+    domain; but it is a purely declarative 4GL.</p><a name="Current_versions" id="Current_versions"/>
 
-    <h2><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=2"
-    title="Edit section: Current versions">edit</a>]</span>
+    <h2>
     <span class="mw-headline">Current versions</span></h2>
 
     <ul>
       <li>The current STABLE version of ADL is 1.1.
 
         <ul>
-          <li>The namespace URL for ADL 1.1 is <a href=
-          "http://libs.cygnets.co.uk/adl/1.1/" class=
-          "external free" title=
-          "http://libs.cygnets.co.uk/adl/1.1/" rel=
-          "nofollow">http://libs.cygnets.co.uk/adl/1.1/</a></li>
+          <li>The namespace URL for ADL 1.1 is <a href="http://libs.cygnets.co.uk/adl/1.1/" class="external free" title="http://libs.cygnets.co.uk/adl/1.1/" rel="nofollow">http://libs.cygnets.co.uk/adl/1.1/</a></li>
 
-          <li>Transforms for ADL 1.1 can be found at <a href=
-          "http://libs.cygnets.co.uk/adl/1.1/ADL/transforms/"
-          class="external free" title=
-          "http://libs.cygnets.co.uk/adl/1.1/ADL/transforms/" rel=
-          "nofollow">http://libs.cygnets.co.uk/adl/1.1/ADL/transforms/</a></li>
+          <li>Transforms for ADL 1.1 can be found at <a href="http://libs.cygnets.co.uk/adl/1.1/ADL/transforms/" class="external free" title="http://libs.cygnets.co.uk/adl/1.1/ADL/transforms/" rel="nofollow">http://libs.cygnets.co.uk/adl/1.1/ADL/transforms/</a></li>
 
           <li>The document type definition for ADL 1.1 can be found
-          at <a href=
-          "http://libs.cygnets.co.uk/adl/1.1/ADL/schemas/adl-1.1.dtd"
-          class="external free" title=
-          "http://libs.cygnets.co.uk/adl/1.1/ADL/schemas/adl-1.1.dtd"
-          rel=
-          "nofollow">http://libs.cygnets.co.uk/adl/1.1/ADL/schemas/adl-1.1.dtd</a></li>
+          at <a href="http://libs.cygnets.co.uk/adl/1.1/ADL/schemas/adl-1.1.dtd" class="external free" title="http://libs.cygnets.co.uk/adl/1.1/ADL/schemas/adl-1.1.dtd" rel="nofollow">http://libs.cygnets.co.uk/adl/1.1/ADL/schemas/adl-1.1.dtd</a></li>
         </ul>
       </li>
 
       <li>the current UNSTABLE version of ADL is 1.2. The namespace
-      URL for ADL 1.2 is <a href=
-      "http://libs.cygnets.co.uk/adl/1.2/" class="external free"
-      title="http://libs.cygnets.co.uk/adl/1.2/" rel=
-      "nofollow">http://libs.cygnets.co.uk/adl/1.2/</a>
+      URL for ADL 1.2 is <a href="http://libs.cygnets.co.uk/adl/1.2/" class="external free" title="http://libs.cygnets.co.uk/adl/1.2/" rel="nofollow">http://libs.cygnets.co.uk/adl/1.2/</a>
 
         <ul>
-          <li>The namespace URL for ADL 1.2 is <a href=
-          "http://libs.cygnets.co.uk/adl/1.2/" class=
-          "external free" title=
-          "http://libs.cygnets.co.uk/adl/1.2/" rel=
-          "nofollow">http://libs.cygnets.co.uk/adl/1.2/</a></li>
+          <li>The namespace URL for ADL 1.2 is <a href="http://libs.cygnets.co.uk/adl/1.2/" class="external free" title="http://libs.cygnets.co.uk/adl/1.2/" rel="nofollow">http://libs.cygnets.co.uk/adl/1.2/</a></li>
 
-          <li>Transforms for ADL 1.2 can be found at <a href=
-          "http://libs.cygnets.co.uk/adl/1.2/ADL/transforms/"
-          class="external free" title=
-          "http://libs.cygnets.co.uk/adl/1.2/ADL/transforms/" rel=
-          "nofollow">http://libs.cygnets.co.uk/adl/1.2/ADL/transforms/</a></li>
+          <li>Transforms for ADL 1.2 can be found at <a href="http://libs.cygnets.co.uk/adl/1.2/ADL/transforms/" class="external free" title="http://libs.cygnets.co.uk/adl/1.2/ADL/transforms/" rel="nofollow">http://libs.cygnets.co.uk/adl/1.2/ADL/transforms/</a></li>
 
           <li>The document type definition for ADL 1.2 can be found
-          at <a href=
-          "http://libs.cygnets.co.uk/adl/1.2/ADL/schemas/adl-1.2.dtd"
-          class="external free" title=
-          "http://libs.cygnets.co.uk/adl/1.2/ADL/schemas/adl-1.2.dtd"
-          rel=
-          "nofollow">http://libs.cygnets.co.uk/adl/1.2/ADL/schemas/adl-1.2.dtd</a></li>
+          at <a href="http://libs.cygnets.co.uk/adl/1.2/ADL/schemas/adl-1.2.dtd" class="external free" title="http://libs.cygnets.co.uk/adl/1.2/ADL/schemas/adl-1.2.dtd" rel="nofollow">http://libs.cygnets.co.uk/adl/1.2/ADL/schemas/adl-1.2.dtd</a></li>
         </ul>
       </li>
-    </ul><a name=
-    "What_is_the_Application_Description_Language_Framework.3F" id=
-    "What_is_the_Application_Description_Language_Framework.3F"></a>
+    </ul><a name="What_is_the_Application_Description_Language_Framework.3F" id="What_is_the_Application_Description_Language_Framework.3F"/>
 
-    <h2><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=3"
-    title=
-    "Edit section: What is the Application Description Language Framework?">edit</a>]</span>
+    <h2>
     <span class="mw-headline">What is the Application Description
     Language Framework?</span></h2>
 
     <p>The Application Description Language Framework is
     principally a set of XSL transforms which transform a single
     ADL file into all the various source files required to build an
-    application.</p><a name="Why_does_it_matter.3F" id=
-    "Why_does_it_matter.3F"></a>
+    application.</p><a name="Why_does_it_matter.3F" id="Why_does_it_matter.3F"/>
 
-    <h2><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=4"
-    title="Edit section: Why does it matter?">edit</a>]</span>
+    <h2>
     <span class="mw-headline">Why does it matter?</span></h2>
 
     <p>The average data driven web application comprises pages
@@ -465,43 +302,27 @@
     of application development so that we can devote more time to
     the fun, interesting and novel bits. It is not intended to be
     an academic, perfect, 100% solution - although for many
-    applications it may in practice be a 100% solution.</p><a name=
-    "Automated_Application_Generation" id=
-    "Automated_Application_Generation"></a>
+    applications it may in practice be a 100% solution.</p><a name="Automated_Application_Generation" id="Automated_Application_Generation"/>
 
-    <h3><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=5"
-    title=
-    "Edit section: Automated Application Generation">edit</a>]</span>
+    <h3>
     <span class="mw-headline">Automated Application
     Generation</span></h3>
 
     <p>Thus to create a new application, all that should be
     necessary is to create a new ADL file, and to compile it using
-    a single, standardised [<a href="http://nant.sourceforge.net/"
-    class="external text" title="http://nant.sourceforge.net/" rel=
-    "nofollow">NAnt</a>] (or [<a href="http://ant.apache.org/"
-    class="external text" title="http://ant.apache.org/" rel=
-    "nofollow">Ant</a>]) build file using scripts already created
+    a single, standardised [<a href="http://nant.sourceforge.net/" class="external text" title="http://nant.sourceforge.net/" rel="nofollow">NAnt</a>] (or [<a href="http://ant.apache.org/" class="external text" title="http://ant.apache.org/" rel="nofollow">Ant</a>]) build file using scripts already created
     as part of the framework. All these scripts (with the exception
     of the PSQL one, which was pre-existing) have been created as
-    part of the <a href=
-    "http://wiki.cygnets.co.uk/index.php/C1873_-_SRU_-_Hospitality"
-    title="C1873 - SRU - Hospitality">C1873 - SRU - Hospitality</a>
+    part of the <a href="http://wiki.cygnets.co.uk/index.php/C1873_-_SRU_-_Hospitality" title="C1873 - SRU - Hospitality">C1873 - SRU - Hospitality</a>
     contract, but they contain almost no SRU specific material (and
     what does exist has been designed to be factored out).
     Prototype 1 of the SRU Hospitality Application contains no
     hand-written code whatever - all the application code is
     automatically generated from the single ADL file. The one
     exception to this rule is the CSS stylesheet which provides
-    look-and-feel and branding.</p><a name=
-    "Integration_with_hand-written_code" id=
-    "Integration_with_hand-written_code"></a>
+    look-and-feel and branding.</p><a name="Integration_with_hand-written_code" id="Integration_with_hand-written_code"/>
 
-    <h3><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=6"
-    title=
-    "Edit section: Integration with hand-written code">edit</a>]</span>
+    <h3>
     <span class="mw-headline">Integration with hand-written
     code</span></h3>
 
@@ -512,14 +333,9 @@
     the C# entity controller classes generated are intentionally
     generated as <i>partial</i> classes, so that they may be
     complemented by other partial classes which may be manually
-    maintained and held in a version control system.</p><a name=
-    "High_quality_auto-generated_code" id=
-    "High_quality_auto-generated_code"></a>
+    maintained and held in a version control system.</p><a name="High_quality_auto-generated_code" id="High_quality_auto-generated_code"/>
 
-    <h3><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=7"
-    title=
-    "Edit section: High quality auto-generated code">edit</a>]</span>
+    <h3>
     <span class="mw-headline">High quality auto-generated
     code</span></h3>
 
@@ -608,108 +424,63 @@
 
     <p>This means that it should be trivial to decide at some point
     in development of a project to manually modify and maintain
-    auto-generated code.</p><a name=
-    "What_can_the_Application_Description_Language_framework_now_do.3F"
-    id=
-    "What_can_the_Application_Description_Language_framework_now_do.3F"></a>
+    auto-generated code.</p><a name="What_can_the_Application_Description_Language_framework_now_do.3F" id="What_can_the_Application_Description_Language_framework_now_do.3F"/>
 
-    <h2><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=8"
-    title=
-    "Edit section: What can the Application Description Language framework now do?">edit</a>]</span>
+    <h2>
     <span class="mw-headline">What can the Application Description
     Language framework now do?</span></h2>
 
-    <p>Currently the framework includes:</p><a name=
-    "adl2entityclass.xsl" id="adl2entityclass.xsl"></a>
+    <p>Currently the framework includes:</p><a name="adl2entityclass.xsl" id="adl2entityclass.xsl"/>
 
-    <h3><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=9"
-    title="Edit section: adl2entityclass.xsl">edit</a>]</span>
+    <h3>
     <span class="mw-headline">adl2entityclass.xsl</span></h3>
 
     <p>Transforms the ADL file into C# source files for classes
-    which describe the entities in a manner acceptable to <a href=
-    "http://www.hibernate.org/" class="external text" title=
-    "http://www.hibernate.org/" rel="nofollow">NHibernate</a>, a
-    widely used Object/Relational mapping layer.</p><a name=
-    "adl2mssql.xsl" id="adl2mssql.xsl"></a>
+    which describe the entities in a manner acceptable to <a href="http://www.hibernate.org/" class="external text" title="http://www.hibernate.org/" rel="nofollow">NHibernate</a>, a
+    widely used Object/Relational mapping layer.</p><a name="adl2mssql.xsl" id="adl2mssql.xsl"/>
 
-    <h3><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=10"
-    title="Edit section: adl2mssql.xsl">edit</a>]</span>
+    <h3>
     <span class="mw-headline">adl2mssql.xsl</span></h3>
 
     <p>Transforms the ADL file into an SQL script in Microsoft SQL
     Server 2000 syntax which initialises the database required by
     the application, with all relationships, permissions,
-    referential integrity constraints and so on.</p><a name=
-    "adl2views.xsl" id="adl2views.xsl"></a>
+    referential integrity constraints and so on.</p><a name="adl2views.xsl" id="adl2views.xsl"/>
 
-    <h3><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=11"
-    title="Edit section: adl2views.xsl">edit</a>]</span>
+    <h3>
     <span class="mw-headline">adl2views.xsl</span></h3>
 
-    <p>Transforms the ADL file into <a href=
-    "http://velocity.apache.org/" class="external text" title=
-    "http://velocity.apache.org/" rel="nofollow">Velocity</a>
-    template files as used by the <a href=
-    "http://www.castleproject.org/monorail/index.html" class=
-    "external text" title=
-    "http://www.castleproject.org/monorail/index.html" rel=
-    "nofollow">Monorail</a> framework, one template each for all
+    <p>Transforms the ADL file into <a href="http://velocity.apache.org/" class="external text" title="http://velocity.apache.org/" rel="nofollow">Velocity</a>
+    template files as used by the <a href="http://www.castleproject.org/monorail/index.html" class="external text" title="http://www.castleproject.org/monorail/index.html" rel="nofollow">Monorail</a> framework, one template each for all
     the lists, forms and inspectors described in the
-    ADL.</p><a name="adl2controllerclasses.xsl" id=
-    "adl2controllerclasses.xsl"></a>
+    ADL.</p><a name="adl2controllerclasses.xsl" id="adl2controllerclasses.xsl"/>
 
-    <h3><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=12"
-    title=
-    "Edit section: adl2controllerclasses.xsl">edit</a>]</span>
+    <h3>
     <span class="mw-headline">adl2controllerclasses.xsl</span></h3>
 
     <p>Transforms the ADL file into a series of C# source files for
     classes which are controllers as used by the Monorail
-    framework.</p><a name="adl2hibernate.xsl" id=
-    "adl2hibernate.xsl"></a>
+    framework.</p><a name="adl2hibernate.xsl" id="adl2hibernate.xsl"/>
 
-    <h3><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=13"
-    title="Edit section: adl2hibernate.xsl">edit</a>]</span>
+    <h3>
     <span class="mw-headline">adl2hibernate.xsl</span></h3>
 
     <p>Transforms the ADL file into a Hibernate mapping file, used
-    by the <a href="http://www.hibernate.org/" class=
-    "external text" title="http://www.hibernate.org/" rel=
-    "nofollow">Hibernate</a> (<a href="http://java.sun.com/" class=
-    "external text" title="http://java.sun.com" rel=
-    "nofollow">Java</a>) and <a href="http://www.hibernate.org/"
-    class="external text" title="http://www.hibernate.org/" rel=
-    "nofollow">NHibernate</a> (C#) Object/Relational mapping
+    by the <a href="http://www.hibernate.org/" class="external text" title="http://www.hibernate.org/" rel="nofollow">Hibernate</a> (<a href="http://java.sun.com/" class="external text" title="http://java.sun.com" rel="nofollow">Java</a>) and <a href="http://www.hibernate.org/" class="external text" title="http://www.hibernate.org/" rel="nofollow">NHibernate</a> (C#) Object/Relational mapping
     layers. This transform is relatively trivial, since ADL is not
     greatly different from being a superset of the Hibernate
     vocabulary - it describes the same sorts of things but in more
-    detail.</p><a name="adl2pgsql.xsl" id="adl2pgsql.xsl"></a>
+    detail.</p><a name="adl2pgsql.xsl" id="adl2pgsql.xsl"/>
 
-    <h3><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=14"
-    title="Edit section: adl2pgsql.xsl">edit</a>]</span>
+    <h3>
     <span class="mw-headline">adl2pgsql.xsl</span></h3>
 
-    <p>Transforms the ADL file into an SQL script in <a href=
-    "http://www.postgresql.org/" class="external text" title=
-    "http://www.postgresql.org/" rel="nofollow">Postgres</a> 7
+    <p>Transforms the ADL file into an SQL script in <a href="http://www.postgresql.org/" class="external text" title="http://www.postgresql.org/" rel="nofollow">Postgres</a> 7
     syntax which initialises the database required by the
     application, with all relationships, permissions, referential
-    integrity constraints and so on.</p><a name=
-    "So_is_ADL_a_quick_way_to_build_Monorail_applications.3F" id=
-    "So_is_ADL_a_quick_way_to_build_Monorail_applications.3F"></a>
+    integrity constraints and so on.</p><a name="So_is_ADL_a_quick_way_to_build_Monorail_applications.3F" id="So_is_ADL_a_quick_way_to_build_Monorail_applications.3F"/>
 
-    <h2><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=15"
-    title=
-    "Edit section: So is ADL a quick way to build Monorail applications?">edit</a>]</span>
+    <h2>
     <span class="mw-headline">So is ADL a quick way to build
     Monorail applications?</span></h2>
 
@@ -723,53 +494,34 @@
     can't maintain them afterwards.</p>
 
     <p>However ADL wasn't originally conceived with Monorail in
-    mind. It was originally intended to generated LISP for <a href=
-    "http://www.cl-http.org:8001/cl-http/" class="external text"
-    title="http://www.cl-http.org:8001/cl-http/" rel=
-    "nofollow">CLHTTPD</a>, and I have a half-finished set of
+    mind. It was originally intended to generated LISP for <a href="http://www.cl-http.org:8001/cl-http/" class="external text" title="http://www.cl-http.org:8001/cl-http/" rel="nofollow">CLHTTPD</a>, and I have a half-finished set of
     scripts to generate Java as part of the Jacquard2 project which
     I never finished. Because ADL is at a level of abstraction
-    considerably above any <a href=
-    "http://en.wikipedia.org/wiki/Third-generation_programming_language"
-    class="external text" title=
-    "http://en.wikipedia.org/wiki/Third-generation_programming_language"
-    rel="nofollow">3GL</a>, it is inherently agnostic to what 3GL
+    considerably above any <a href="http://en.wikipedia.org/wiki/Third-generation_programming_language" class="external text" title="http://en.wikipedia.org/wiki/Third-generation_programming_language" rel="nofollow">3GL</a>, it is inherently agnostic to what 3GL
     it is compiled down to - so that it would be as easy to write
-    transforms that compiled ADL to <a href=
-    "http://struts.apache.org/" class="external text" title=
-    "http://struts.apache.org/" rel="nofollow">Struts</a> or
-    <a href="http://www.rubyonrails.org/" class="external text"
-    title="http://www.rubyonrails.org/" rel="nofollow">Ruby on
+    transforms that compiled ADL to <a href="http://struts.apache.org/" class="external text" title="http://struts.apache.org/" rel="nofollow">Struts</a> or
+    <a href="http://www.rubyonrails.org/" class="external text" title="http://www.rubyonrails.org/" rel="nofollow">Ruby on
     Rails</a> as to C#/Monorail. More importantly, ADL isn't
     inherently limited to Web applications - it doesn't actually
     know anything about the Web. It should be possible to write
     transforms which compile ADL down to Windows native
     applications or to native applications for mobile phones (and,
     indeed, if we did have those transforms then we could make all
-    our applications platform agnostic).</p><a name=
-    "Limitations_on_ADL" id="Limitations_on_ADL"></a>
+    our applications platform agnostic).</p><a name="Limitations_on_ADL" id="Limitations_on_ADL"/>
 
-    <h2><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=16"
-    title="Edit section: Limitations on ADL">edit</a>]</span>
+    <h2>
     <span class="mw-headline">Limitations on
-    ADL</span></h2><a name="Current_limitations" id=
-    "Current_limitations"></a>
+    ADL</span></h2><a name="Current_limitations" id="Current_limitations"/>
 
-    <h3><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=17"
-    title="Edit section: Current limitations">edit</a>]</span>
+    <h3>
     <span class="mw-headline">Current limitations</span></h3>
 
     <p>Although I've built experimental systems before using ADL,
     the SRU project is the first time I've really used it in anger.
     There are some features I need which it can't yet
-    represent.</p><a name="Authentication_model" id=
-    "Authentication_model"></a>
+    represent.</p><a name="Authentication_model" id="Authentication_model"/>
 
-    <h4><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=18"
-    title="Edit section: Authentication model">edit</a>]</span>
+    <h4>
     <span class="mw-headline">Authentication model</span></h4>
 
     <p>For SRU, I have implemented an authentication model which
@@ -784,21 +536,16 @@
     layer.</p>
 
     <p>ADL defines field-level permissions, but the current
-    controller generator does not implement this.</p><a name=
-    "Alternative_Verbs" id="Alternative_Verbs"></a>
+    controller generator does not implement this.</p><a name="Alternative_Verbs" id="Alternative_Verbs"/>
 
-    <h4><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=19"
-    title="Edit section: Alternative Verbs">edit</a>]</span>
+    <h4>
     <span class="mw-headline">Alternative Verbs</span></h4>
 
     <p>Generically, with an entity form, one needs to be able to
     save the record being edited, and one (often) needs to be able
     to delete it. But sometimes one needs to be able to do other
     things. With SRU, for example, there is a need to be able to
-    export event data to <a href="http://www.perfecttableplan.com/"
-    class="external text" title="http://www.perfecttableplan.com/"
-    rel="nofollow">Perfect Table Plan</a>, and to reimport data
+    export event data to <a href="http://www.perfecttableplan.com/" class="external text" title="http://www.perfecttableplan.com/" rel="nofollow">Perfect Table Plan</a>, and to reimport data
     from Perfect Table Plan. This will need custom buttons on the
     event entity form, and will also need hand-written code at the
     controller layer to respond to those buttons.</p>
@@ -807,12 +554,9 @@
     interaction with the SRU, potentially many invitations. In
     order to access those invitations it will be necessary to
     associate lists of dependent records with forms. Currently ADL
-    cannot represent these.</p><a name="Inherent_limitations" id=
-    "Inherent_limitations"></a>
+    cannot represent these.</p><a name="Inherent_limitations" id="Inherent_limitations"/>
 
-    <h3><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=20"
-    title="Edit section: Inherent limitations">edit</a>]</span>
+    <h3>
     <span class="mw-headline">Inherent limitations</span></h3>
 
     <p>At this stage I doubt whether there is much point in
@@ -822,21 +566,15 @@
     higher level of abstraction than current 3GLs. If using ADL
     does not save work, it isn't worth doing it in ADL; remember
     this is conceived as an 80/20 solution, and you need to be
-    prepared to write the 20 in something else.</p><a name=
-    "ADL_Vocabulary" id="ADL_Vocabulary"></a>
+    prepared to write the 20 in something else.</p><a name="ADL_Vocabulary" id="ADL_Vocabulary"/>
 
-    <h2><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=21"
-    title="Edit section: ADL Vocabulary">edit</a>]</span>
+    <h2>
     <span class="mw-headline">ADL Vocabulary</span></h2>
 
     <p>This section of this document presents and comments on the
-    existing ADL document type definition (DTD).</p><a name=
-    "Basic_definitions" id="Basic_definitions"></a>
+    existing ADL document type definition (DTD).</p><a name="Basic_definitions" id="Basic_definitions"/>
 
-    <h3><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=22"
-    title="Edit section: Basic definitions">edit</a>]</span>
+    <h3>
     <span class="mw-headline">Basic definitions</span></h3>
 
     <p>The DTD starts with some basic definitions</p>
@@ -855,12 +593,9 @@
         &lt;URL:http://www.chemie.fu-berlin.de/diverse/doc/ISO_3166.html&gt;
 --&gt;
 &lt;!ENTITY % Locale "CDATA" &gt;
-</pre><a name="Permissions" id="Permissions"></a>
+</pre><a name="Permissions" id="Permissions"/>
 
-    <h4><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=23"
-    title="Edit section: Permissions">edit</a>]</span> <span class=
-    "mw-headline">Permissions</span></h4>
+    <h4> <span class="mw-headline">Permissions</span></h4>
 
     <p>Key to any data driven application is who has authority to
     do what to what: 'permissions'.</p>
@@ -879,12 +614,9 @@
         all:                    select, insert, update, delete
 --&gt;
 &lt;!ENTITY % Permissions "none|read|insert|noedit|edit|all" &gt;
-</pre><a name="Data_types" id="Data_types"></a>
+</pre><a name="Data_types" id="Data_types"/>
 
-    <h4><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=24"
-    title="Edit section: Data types">edit</a>]</span> <span class=
-    "mw-headline">Data types</span></h4>
+    <h4> <span class="mw-headline">Data types</span></h4>
 
     <p>ADL needs to know what type of data can be stored on
     different properties of different entities. The data types were
@@ -902,11 +634,9 @@
         time:                   time            java.sql.Types.TIME
         timestamp:              timestamp       java.sql.Types.TIMESTAMP
 --&gt;
-</pre><a name="Definable_data_types" id="Definable_data_types"></a>
+</pre><a name="Definable_data_types" id="Definable_data_types"/>
 
-    <h4><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=25"
-    title="Edit section: Definable data types">edit</a>]</span>
+    <h4>
     <span class="mw-headline">Definable data types</span></h4>
 
     <p>However, in order to be able to do data validation, it's
@@ -938,11 +668,9 @@
 
 &lt;!-- all data types --&gt;
 &lt;!ENTITY % AllDataTypes "%ComplexDataTypes;|%SimpleDataTypes;" &gt;
-</pre><a name="Page_content" id="Page_content"></a>
+</pre><a name="Page_content" id="Page_content"/>
 
-    <h4><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=26"
-    title="Edit section: Page content">edit</a>]</span>
+    <h4>
     <span class="mw-headline">Page content</span></h4>
 
     <p>Pages in applications typically have common, often largely
@@ -964,18 +692,12 @@
 &lt;!ENTITY % PageAttrs 
         "name CDATA #REQUIRED
          properties (all|listed) #REQUIRED" &gt;
-</pre><a name="The_Elements" id="The_Elements"></a>
+</pre><a name="The_Elements" id="The_Elements"/>
 
-    <h3><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=27"
-    title="Edit section: The Elements">edit</a>]</span>
-    <span class="mw-headline">The Elements</span></h3><a name=
-    "Application" id="Application"></a>
+    <h3>
+    <span class="mw-headline">The Elements</span></h3><a name="Application" id="Application"/>
 
-    <h4><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=28"
-    title="Edit section: Application">edit</a>]</span> <span class=
-    "mw-headline">Application</span></h4>
+    <h4> <span class="mw-headline">Application</span></h4>
 
     <p>The top level element of an Application Description Language
     file is the application element:</p>
@@ -985,12 +707,9 @@
 &lt;!ATTLIST application 
         name            CDATA                                           #REQUIRED
         version         CDATA                                           #IMPLIED&gt;
-</pre><a name="Definition" id="Definition"></a>
+</pre><a name="Definition" id="Definition"/>
 
-    <h4><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=29"
-    title="Edit section: Definition">edit</a>]</span> <span class=
-    "mw-headline">Definition</span></h4>
+    <h4> <span class="mw-headline">Definition</span></h4>
 
     <p>In order to be able to use defined types, you need to be
     able to provide definitions of these types:</p>
@@ -1012,12 +731,9 @@
         pattern         CDATA                                           #IMPLIED
         minimum         CDATA                                           #IMPLIED
         maximum         CDATA                                           #IMPLIED&gt;
-</pre><a name="Groups" id="Groups"></a>
+</pre><a name="Groups" id="Groups"/>
 
-    <h4><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=30"
-    title="Edit section: Groups">edit</a>]</span> <span class=
-    "mw-headline">Groups</span></h4>
+    <h4> <span class="mw-headline">Groups</span></h4>
 
     <p>In order to be able to user permissions, we need to define
     who has those permissions. Groups in ADL map directly onto
@@ -1030,12 +746,9 @@
 &lt;!ATTLIST group name CDATA #REQUIRED&gt;
 &lt;!-- the name of a group of which this group is subset --&gt;
 &lt;!ATTLIST group parent CDATA #IMPLIED&gt;
-</pre><a name="Enities_and_Properties" id=
-"Enities_and_Properties"></a>
+</pre><a name="Enities_and_Properties" id="Enities_and_Properties"/>
 
-    <h4><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=31"
-    title="Edit section: Enities and Properties">edit</a>]</span>
+    <h4>
     <span class="mw-headline">Enities and Properties</span></h4>
 
     <p>A thing-in-the-domain has properties. Things in the domain
@@ -1087,12 +800,9 @@
         required        %Boolean;                                       #IMPLIED
         size            CDATA                                           #IMPLIED&gt;
 
-</pre><a name="Options" id="Options"></a>
+</pre><a name="Options" id="Options"/>
 
-    <h4><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=32"
-    title="Edit section: Options">edit</a>]</span> <span class=
-    "mw-headline">Options</span></h4>
+    <h4> <span class="mw-headline">Options</span></h4>
 
     <p>Sometimes a property has a constrained list of specific
     values; this is represented for example in the enumerated types
@@ -1109,12 +819,9 @@
 &lt;!ELEMENT option (prompt*)&gt;
 &lt;!-- if the value is different from the prompt the user sees, specify it --&gt;
 &lt;!ATTLIST option value CDATA #IMPLIED&gt;
-</pre><a name="Permissions_2" id="Permissions_2"></a>
+</pre><a name="Permissions_2" id="Permissions_2"/>
 
-    <h4><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=33"
-    title="Edit section: Permissions">edit</a>]</span> <span class=
-    "mw-headline">Permissions</span></h4>
+    <h4> <span class="mw-headline">Permissions</span></h4>
 
     <p>Permissions define policies to allow groups of users to
     access forms, pages, fields (not yet implemented) or entities.
@@ -1135,12 +842,9 @@
         group           CDATA                                   #REQUIRED
         permission      (%Permissions;)                         #REQUIRED&gt;
 
-</pre><a name="Pragmas" id="Pragmas"></a>
+</pre><a name="Pragmas" id="Pragmas"/>
 
-    <h4><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=34"
-    title="Edit section: Pragmas">edit</a>]</span> <span class=
-    "mw-headline">Pragmas</span></h4>
+    <h4> <span class="mw-headline">Pragmas</span></h4>
 
     <p>Pragmas are currently not used at all. They are there as a
     possible means to provide additional controls on forms, but may
@@ -1157,13 +861,9 @@
       name  CDATA   #REQUIRED
       value CDATA   #REQUIRED&gt;
 
-</pre><a name="Prompts.2C_helptexts_and_error_texts" id=
-"Prompts.2C_helptexts_and_error_texts"></a>
+</pre><a name="Prompts.2C_helptexts_and_error_texts" id="Prompts.2C_helptexts_and_error_texts"/>
 
-    <h4><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=35"
-    title=
-    "Edit section: Prompts, helptexts and error texts">edit</a>]</span>
+    <h4>
     <span class="mw-headline">Prompts, helptexts and error
     texts</span></h4>
 
@@ -1218,12 +918,9 @@
 &lt;!ELEMENT ifmissing (#PCDATA)&gt;
 &lt;!ATTLIST ifmissing
       locale  %Locale;  #IMPLIED&gt;
-</pre><a name="Forms.2C_Pages_and_Lists" id=
-"Forms.2C_Pages_and_Lists"></a>
+</pre><a name="Forms.2C_Pages_and_Lists" id="Forms.2C_Pages_and_Lists"/>
 
-    <h4><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=36"
-    title="Edit section: Forms, Pages and Lists">edit</a>]</span>
+    <h4>
     <span class="mw-headline">Forms, Pages and Lists</span></h4>
 
     <p>The basic pages of the user interface. Pages and Forms by
@@ -1287,20 +984,13 @@
 --&gt;
 &lt;!ELEMENT foot (#PCDATA) &gt;
 
-</pre><a name="Using_ADL_in_your_project" id=
-"Using_ADL_in_your_project"></a>
+</pre><a name="Using_ADL_in_your_project" id="Using_ADL_in_your_project"/>
 
-    <h2><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=37"
-    title=
-    "Edit section: Using ADL in your project">edit</a>]</span>
+    <h2>
     <span class="mw-headline">Using ADL in your
-    project</span></h2><a name="Selecting_the_version" id=
-    "Selecting_the_version"></a>
+    project</span></h2><a name="Selecting_the_version" id="Selecting_the_version"/>
 
-    <h3><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=38"
-    title="Edit section: Selecting the version">edit</a>]</span>
+    <h3>
     <span class="mw-headline">Selecting the version</span></h3>
 
     <p>Current versions of ADL are given at the top of this
@@ -1329,10 +1019,7 @@
 
         <ul>
           <li>You can access 0.3, should you need to, here:
-          <a href="http://libs.cygnets.co.uk/adl/0.3/ADL/" class=
-          "external free" title=
-          "http://libs.cygnets.co.uk/adl/0.3/ADL/" rel=
-          "nofollow">http://libs.cygnets.co.uk/adl/0.3/ADL/</a></li>
+          <a href="http://libs.cygnets.co.uk/adl/0.3/ADL/" class="external free" title="http://libs.cygnets.co.uk/adl/0.3/ADL/" rel="nofollow">http://libs.cygnets.co.uk/adl/0.3/ADL/</a></li>
 
           <li>I do not plan to maintain 0.3 even for bugfixes; you
           should ensure your project builds with 1.0</li>
@@ -1362,11 +1049,7 @@
           <li>If you want new functionality, it belongs in
           'unstable'.</li>
 
-          <li>You can access 1.0 here: <a href=
-          "http://libs.cygnets.co.uk/adl/1.0/ADL/" class=
-          "external free" title=
-          "http://libs.cygnets.co.uk/adl/1.0/ADL/" rel=
-          "nofollow">http://libs.cygnets.co.uk/adl/1.0/ADL/</a></li>
+          <li>You can access 1.0 here: <a href="http://libs.cygnets.co.uk/adl/1.0/ADL/" class="external free" title="http://libs.cygnets.co.uk/adl/1.0/ADL/" rel="nofollow">http://libs.cygnets.co.uk/adl/1.0/ADL/</a></li>
 
           <li>Projects using ADL 1.0 should be built with the 1.0
           version of CygnetToolkit</li>
@@ -1388,11 +1071,7 @@
           release of a product to a customer we may wish to move
           changes into a new 'stable' branch.</li>
 
-          <li>You can access the unstable branch here: <a href=
-          "http://libs.cygnets.co.uk/adl/unstable/ADL/" class=
-          "external free" title=
-          "http://libs.cygnets.co.uk/adl/unstable/ADL/" rel=
-          "nofollow">http://libs.cygnets.co.uk/adl/unstable/ADL/</a></li>
+          <li>You can access the unstable branch here: <a href="http://libs.cygnets.co.uk/adl/unstable/ADL/" class="external free" title="http://libs.cygnets.co.uk/adl/unstable/ADL/" rel="nofollow">http://libs.cygnets.co.uk/adl/unstable/ADL/</a></li>
 
           <li>The version at that location is automatically updated
           from CVS every night</li>
@@ -1402,24 +1081,17 @@
           of CygnetToolkit.</li>
         </ul>
       </li>
-    </ul><a name="Integrating_into_your_build" id=
-    "Integrating_into_your_build"></a>
+    </ul><a name="Integrating_into_your_build" id="Integrating_into_your_build"/>
 
-    <h3><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=39"
-    title=
-    "Edit section: Integrating into your build">edit</a>]</span>
+    <h3>
     <span class="mw-headline">Integrating into your
     build</span></h3>
 
     <p>To use ADL, it is currently most convenient to use NAnt. It
     is probably possible to do this with MSBuild, but as of yet I
-    don't know how.</p><a name="Properties" id="Properties"></a>
+    don't know how.</p><a name="Properties" id="Properties"/>
 
-    <h4><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=40"
-    title="Edit section: Properties">edit</a>]</span> <span class=
-    "mw-headline">Properties</span></h4>
+    <h4> <span class="mw-headline">Properties</span></h4>
 
     <p>For the examples given here to work, you will need to set up
     at least the following properties in your NAnt
@@ -1448,12 +1120,9 @@
     and your ADL file, respectively. Note that if it is to be used
     as an assembly name, the project name should include neither
     spaces, hyphens nor periods. If it must do so, you should give
-    an assembly name which does not, explicitly.</p><a name=
-    "Canonicalisation" id="Canonicalisation"></a>
+    an assembly name which does not, explicitly.</p><a name="Canonicalisation" id="Canonicalisation"/>
 
-    <h4><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=41"
-    title="Edit section: Canonicalisation">edit</a>]</span>
+    <h4>
     <span class="mw-headline">Canonicalisation</span></h4>
 
     <p>The first thing you need to do with your ADL file is
@@ -1469,13 +1138,9 @@
                         &lt;/parameters&gt;
                 &lt;/style&gt;
         &lt;/target&gt;
-</pre><a name="Generate_NHibernate_mapping" id=
-"Generate_NHibernate_mapping"></a>
+</pre><a name="Generate_NHibernate_mapping" id="Generate_NHibernate_mapping"/>
 
-    <h4><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=42"
-    title=
-    "Edit section: Generate NHibernate mapping">edit</a>]</span>
+    <h4>
     <span class="mw-headline">Generate NHibernate
     mapping</span></h4>
 
@@ -1493,11 +1158,9 @@
                         &lt;/parameters&gt;
                 &lt;/style&gt;
         &lt;/target&gt;
-</pre><a name="Generate_SQL" id="Generate_SQL"></a>
+</pre><a name="Generate_SQL" id="Generate_SQL"/>
 
-    <h4><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=43"
-    title="Edit section: Generate SQL">edit</a>]</span>
+    <h4>
     <span class="mw-headline">Generate SQL</span></h4>
     <pre>
    &lt;target name="sql" description="Generates cadlink database initialisation script"
@@ -1511,22 +1174,16 @@
                         &lt;/parameters&gt;
                 &lt;/style&gt;
         &lt;/target&gt;
-</pre><a name="Generate_C.23_entity_classes_.28.27POCOs.27.29"
-    id="Generate_C.23_entity_classes_.28.27POCOs.27.29"></a>
+</pre><a name="Generate_C.23_entity_classes_.28.27POCOs.27.29" id="Generate_C.23_entity_classes_.28.27POCOs.27.29"/>
 
-    <h4><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=44"
-    title=
-    "Edit section: Generate C# entity classes ('POCOs')">edit</a>]</span>
+    <h4>
     <span class="mw-headline">Generate C# entity classes
     ('POCOs')</span></h4>
 
     <p>Note that for this to work you must have the following:</p>
 
     <ul>
-      <li>'<a href="http://astyle.sourceforge.net/" class=
-      "external text" title="http://astyle.sourceforge.net/" rel=
-      "nofollow">Artistic Style</a>' installed as <code>c:\Program
+      <li>'<a href="http://astyle.sourceforge.net/" class="external text" title="http://astyle.sourceforge.net/" rel="nofollow">Artistic Style</a>' installed as <code>c:\Program
       Files\astyle\bin\astyle.exe</code></li>
     </ul>
     <pre>
@@ -1556,22 +1213,16 @@
                         destdir="${src.dir}/Entities"
                         pattern="cut here: next file '([a-zA-Z0-9_.]*)'"/&gt;
         &lt;/target&gt;
-</pre><a name="Generate_Monorail_controller_classes" id=
-"Generate_Monorail_controller_classes"></a>
+</pre><a name="Generate_Monorail_controller_classes" id="Generate_Monorail_controller_classes"/>
 
-    <h4><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=45"
-    title=
-    "Edit section: Generate Monorail controller classes">edit</a>]</span>
+    <h4>
     <span class="mw-headline">Generate Monorail controller
     classes</span></h4>
 
     <p>Note that for this to work you must have</p>
 
     <ul>
-      <li>'<a href="http://astyle.sourceforge.net/" class=
-      "external text" title="http://astyle.sourceforge.net/" rel=
-      "nofollow">Artistic Style</a>' installed as <code>c:\Program
+      <li>'<a href="http://astyle.sourceforge.net/" class="external text" title="http://astyle.sourceforge.net/" rel="nofollow">Artistic Style</a>' installed as <code>c:\Program
       Files\astyle\bin\astyle.exe</code></li>
 
       <li>The 'fetchtasks' target from the 'entity classes' stanza,
@@ -1600,13 +1251,9 @@
                 &lt;split-regex in="${tmpdir}/controllers.auto.cs"
                                    destdir="${controllers}/Auto" pattern="cut here: next file '([a-zA-Z0-9_.]*)'"/&gt;
         &lt;/target&gt;
-</pre><a name="Generate_Velocity_views_for_use_with_Monorail"
-    id="Generate_Velocity_views_for_use_with_Monorail"></a>
+</pre><a name="Generate_Velocity_views_for_use_with_Monorail" id="Generate_Velocity_views_for_use_with_Monorail"/>
 
-    <h4><span class="editsection">[<a href=
-    "http://wiki.cygnets.co.uk/index.php?title=Application_Description_Language_framework&amp;action=edit&amp;section=46"
-    title=
-    "Edit section: Generate Velocity views for use with Monorail">edit</a>]</span>
+    <h4>
     <span class="mw-headline">Generate Velocity views for use with
     Monorail</span></h4>
 
@@ -1617,7 +1264,7 @@
       above.</li>
     </ul>
 
-    <p><br /></p>
+    <p><br/></p>
     <pre>
    &lt;target name="views" description="creates Velocity templates"
                         depends="fetchtasks canonicalise"&gt;
diff --git a/documentation.css b/documentation.css
index a77f069..2f96cbf 100755
--- a/documentation.css
+++ b/documentation.css
@@ -1,43 +1,169 @@
- /******************************************************
-  *    Application Description Language framework
-  *    adl2documentation.xslt
-  *    
-  *    (c) 2007 Cygnet Solutions Ltd
-  *    
-  *    Produce basic documentation of an ADL file
-  *    
-  *    $Author: sb $
-  *    $Revision: 1.2 $
-  *
-  ******************************************************/
-  
-BODY 
+/************************************************************************\
+ *                                                                      *
+ *      weft.css                                                    	  *
+ *                                                                      *
+ *      Purpose: rational reconstruction of the lost Weft stylesheet.	  *
+ *                                                                      *
+ *      Author:    Simon Brooke                                         *
+ *      Created:   2nd November 2013                                    *
+ *                                                                      *
+\************************************************************************/
+
+body
 {
-	color: Black;
-	background-color: White;
-	font-family: Sans-Serif;
-}
-  
-TD, TH 
-{
-	text-align: left;
-	vertical-align: top;
-	padding: 0.1em 0.5em;
+  background: white;
+  color: black;
+  font-family: helvetica, gill, ariel, sans-serif;
+  margin: 3em 20% 5em 20%;
+  width: 60%;
 }
 
-.documentation
+
+a:link
 {
-	font-style: italic;
+  color: rgb( 64, 64, 64);
 }
 
-.odd
+a:hover, a:active
 {
-	color: Black;
-	background-color: rgb( 240, 240, 256);
+  background: silver;
 }
 
-.even
+a:visited
 {
-	color: Black;
-	background-color: rgb( 240, 256, 240);
-}
\ No newline at end of file
+  color: rgb( 128,128,192);
+}
+
+blockquote
+{
+  font-family: 'URW Chancery L', 'Monotype Corsiva', 'Apple Chancery', 'ITC Zapf Chancery', cursive;
+  font-weight: lighter;
+  font-style: italic;
+  color:  rgb( 128,128,192);
+  margin-left: 0.5em;
+  margin-right: 1em;
+}
+
+footer {
+  font-size: smaller;
+  text-align: center;
+  bottom: 0;
+}
+
+header {
+  top: 0;
+}
+
+header, footer {
+  width: 100%;
+  position: fixed;
+  z-index: 149;
+  background-color: rgba( 255, 255, 255, 0.8);
+}
+
+h1 {
+  text-indent: -3em;
+  padding-left: 3em;
+  line-height: 130%;
+}
+
+h1, h2, h3, h4, h5, dt
+{
+  font-family: "Arial Black", Impact, sans-serif;
+  color: rgb( 128, 128, 128);
+  text-align: left;
+  margin-left: 0.5em;
+  margin-right: 1em;
+  font-weight: 900;
+}
+
+h1 em {
+  font-size: 200%;
+  vertical-align: top;
+}
+
+h1 strong {
+  font-size: 250%;
+}
+
+h1 em, h2 em, h3 em, h4 em, h5 em {
+  font-family: 'URW Chancery L', 'Monotype Corsiva', 'Apple Chancery', 'ITC Zapf Chancery', cursive;
+  font-weight: lighter;
+  font-style: italic;
+  color: rgb( 128,128,192);
+}
+
+h1, h2, h3, h4, h5 {
+}
+
+hr
+{
+  margin-left: 1em;
+  margin-right: 1em;
+  height: 1px;
+}
+
+p
+{
+  margin-left: 1em;
+  margin-right: 2em;
+  text-align: justify;
+  font-family: helvetica, gill, ariel, sans-serif;
+}
+
+ul.navbox {
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+
+.copyright
+{
+  color: rgb( 128,128,192);
+  font-size: x-small;
+  text-align: center;
+}
+
+.logo
+{
+  color:  rgb( 128,128,192);
+  font-style: normal;
+  float: left;
+}
+
+.help
+{
+  font-style: italic;
+  background: silver;
+}
+
+.daynum
+{
+  color: white;
+  background: rgb( 128,128,192);
+  font-weight: bold;
+}
+
+#nav {
+  margin: 0;
+  padding: 0;
+  width: 100%;
+  background:rgba(255,255,255,0.8);
+}
+
+#nav ul li {
+  padding: 0;
+  margin: 0;
+  display: inline;
+}
+
+#nav ul li a {
+  text-decoration: none;
+  font-weight: bold;
+  padding: 0.1em 0.75em;
+  margin: 0;
+}
+
+#nav ul li.active a { background: silver;}
+#nav ul li a:hover { background: silver; }
+#nav ul li a:active { background: gray; color: white; }
diff --git a/remove-edit-sections.xslt b/remove-edit-sections.xslt
new file mode 100644
index 0000000..adff59a
--- /dev/null
+++ b/remove-edit-sections.xslt
@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<xsl:stylesheet version="1.0"
+	xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
+
+  <xsl:output method="xml" indent="yes" encoding="UTF-8" omit-xml-declaration="yes"/>
+
+  <xsl:template match="*[@class='editsection']">
+  </xsl:template>
+
+    <!-- just copy anything we can't match -->
+  <xsl:template match="@* | node()">
+    <xsl:copy>
+      <xsl:apply-templates select="@* | node()"/>
+    </xsl:copy>
+  </xsl:template>
+</xsl:stylesheet>
\ No newline at end of file
diff --git a/schemas/adl-1.4.dtd b/schemas/adl-1.4.dtd
index d8286e3..a5f9ae5 100755
--- a/schemas/adl-1.4.dtd
+++ b/schemas/adl-1.4.dtd
@@ -11,7 +11,7 @@
     <!--	Copyright:	(c) 2007 Cygnet Solutions								                  -->
     <!--      							      		                                          -->
     <!--  ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::  -->
-    
+
     <!--
         $Revision: 1.5 $
  	    -->
@@ -24,8 +24,8 @@
 <!--  Before we start: some useful definitions					                -->
 <!--  ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::  -->
 
-<!-- some basic character entities inherited from HTML. Actually we probably ought to 
-import all the HTML4 character entity files, and possibly the HTML4 Strict DTD (so 
+<!-- some basic character entities inherited from HTML. Actually we probably ought to
+import all the HTML4 character entity files, and possibly the HTML4 Strict DTD (so
 that we can allow HTML block level entities within content elements -->
 <!ENTITY nbsp "&#160;">
 <!ENTITY pound "&#163;">
@@ -35,7 +35,7 @@ that we can allow HTML block level entities within content elements -->
 <!-- boolean means true or false -->
 <!ENTITY % Boolean "(true|false)" >
 
-<!-- 
+<!--
 	Locale is a string comprising an ISO 639 language code followed by a space
 	followed by an ISO 3166 country code, or else the string 'default'. See:
 	<URL:http://www.ics.uci.edu/pub/ietf/http/related/iso639.txt>
@@ -43,12 +43,12 @@ that we can allow HTML block level entities within content elements -->
 -->
 <!ENTITY % Locale "CDATA" >
 
-<!-- 
+<!--
 	permissions a group may have on an entity, list, page, form or field
-	permissions are deemed to increase as you go right. A group cannot 
+	permissions are deemed to increase as you go right. A group cannot
 	have greater permission on a field than on the form it is in, or
 	greater permission on form than the entity it belongs to
-	
+
 	none:			none
 	read:			select
 	insert:			insert
@@ -61,10 +61,10 @@ that we can allow HTML block level entities within content elements -->
 
 <!--
   actions which should be cascaded to dependent objects. All these values except
-  'manual' are taken from Hibernate and should be passed through the adl2hibernate 
+  'manual' are taken from Hibernate and should be passed through the adl2hibernate
   mapping transparently. Relevent only for properties with type='entity', type='link'
   and type='list'
-  
+
   all :       cascade delete, save and update
   all-delete-orphan : see hibernate documentation; relates to transient objects only
   delete :    cascade delete actions, but not save and update
@@ -74,47 +74,47 @@ that we can allow HTML block level entities within content elements -->
 -->
 <!ENTITY % CascadeActions "all|all-delete-orphan|delete|manual|save-update">
 
-<!-- 
-	data types which can be used in a typedef to provide validation - 
-	e.g. a string can be used with a regexp or a scalar can be used with 
-	min and max values 
-	string: 		varchar		java.sql.Types.VARCHAR
-	integer:		int			java.sql.Types.INTEGER
-	real:			double		java.sql.Types.DOUBLE
-	money:			money		java.sql.Types.INTEGER
-	date:			date		java.sql.Types.DATE
-	time:			time		java.sql.Types.TIME
+<!--
+	data types which can be used in a typedef to provide validation -
+	e.g. a string can be used with a regexp or a scalar can be used with
+	min and max values
+	string: 		  varchar		java.sql.Types.VARCHAR
+	integer:		  int			  java.sql.Types.INTEGER
+	real:			    double		java.sql.Types.DOUBLE
+	money:			  money		  java.sql.Types.INTEGER
+	date:			    date		  java.sql.Types.DATE
+	time:			    time		  java.sql.Types.TIME
 	timestamp:		timestamp	java.sql.Types.TIMESTAMP
-	uploadable:		varchar		java.sql.Types.VARCHAR 
-	image:			varchar		java.sql.Types.VARCHAR
-	
+	uploadable:		varchar		java.sql.Types.VARCHAR
+	image:			  varchar		java.sql.Types.VARCHAR
+
 	uploadable is as string but points to an uploaded file; image is as
 	uploadable but points to an uploadable graphical image file
 -->
 <!ENTITY % DefinableDataTypes "string|integer|real|money|date|time|timestamp|uploadable" >
 
-<!-- 
+<!--
 	data types which are fairly straightforward translations of JDBC data types
 	boolean:		boolean or	java.sql.Types.BIT
-					char(1)		java.sql.Types.CHAR
-	text:			text or		java.sql.Types.LONGVARCHAR 
-					memo		java.sql.Types.CLOB
+					    char(1)		  java.sql.Types.CHAR
+	text:			  text or		  java.sql.Types.LONGVARCHAR
+					    memo		    java.sql.Types.CLOB
 -->
 <!ENTITY % SimpleDataTypes "%DefinableDataTypes;|boolean|text" >
 
-<!-- 
+<!--
 	data types which are more complex than SimpleDataTypes...
-	entity : 		a foreign key link to another entity (i.e. the 'many' end of a 
-					one-to-many link);
+	entity : 		a foreign key link to another entity (i.e. the 'many' end of a
+					    one-to-many link);
 	list :			a list of some other entity that links to me (i.e. the 'one' end of
-					a one-to-many link);
+					    a one-to-many link);
 	link : 			a many to many link (via a link table);
-	defined : 		a type defined by a typedef.
+	defined : 	a type defined by a typedef.
 -->
 <!ENTITY % ComplexDataTypes "entity|link|list|defined" >
 
 <!--
-  data types which require special handling - which don't simply map onto 
+  data types which require special handling - which don't simply map onto
   common SQL data types
   geopos :    a latitude/longitude pair (experimental and not yet implemented)
   image :     a raster image file, in jpeg|gif|png format (experimental, not yet implemented)
@@ -142,15 +142,15 @@ that we can allow HTML block level entities within content elements -->
                       present)
       user-distinct:  all properties which are user-distinct (NOTE: Not yet implemented)
       listed:         only those properties for which fields are explicitly listed
--->  
-<!ENTITY % PageAttrs 
+-->
+<!ENTITY % PageAttrs
 	"name CDATA #REQUIRED
 	 properties (all|user-distinct|listed) #REQUIRED" >
 
 <!-- Actions for generators (mainly for keyfields - see entity 'generator', below
-  assigned:           In manually-maintained code, you contract to assign a value 
+  assigned:           In manually-maintained code, you contract to assign a value
                       to this property before it is persisted.
-  guid:               The system will supply a unique GUid value to this field 
+  guid:               The system will supply a unique GUid value to this field
                       before it is persisted.
   mannual:            You contract to supply a generatos class in manually maintained
                       code.
@@ -163,7 +163,7 @@ that we can allow HTML block level entities within content elements -->
   canonical:          Whatever the normal canonical ordering for this datatype is -
                       typically alpha-numeric, except for dates, etc.
   reverse-canonical:  The reverse of the above
-  
+
   possibly there should be some further values but I have no idea what these are
 -->
 <!ENTITY % Sequences "canonical|reverse-canonical">
@@ -172,9 +172,9 @@ that we can allow HTML block level entities within content elements -->
 <!--  Elements																	                                -->
 <!--  ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::  -->
 
-<!-- 
+<!--
   the application that the document describes: required top level element
-  
+
   name:     the name of this application
   version:  the version number of this application
   revision:	the revision of the ADL document
@@ -182,14 +182,14 @@ that we can allow HTML block level entities within content elements -->
   xmlns:    XML namespace, in case required
 -->
 <!ELEMENT application ( specification*, documentation?, content?, typedef*,  group*, entity*)>
-<!ATTLIST application 
+<!ATTLIST application
 	name 		CDATA 						#REQUIRED
 	version 	CDATA 						#IMPLIED
 	revision	CDATA						#IMPLIED
 	currency	CDATA						#IMPLIED
 	xmlns		CDATA						#IMPLIED>
 
-<!-- 
+<!--
 	the definition of a defined type. At this stage a defined type is either
 	a string		in which case it must have size and pattern, or
 	a scalar		in which case it must have minimum and/or maximum
@@ -208,22 +208,22 @@ that we can allow HTML block level entities within content elements -->
   -->
 <!ELEMENT typedef (documentation?, in-implementation*, help*) >
 
-<!ATTLIST typedef 
-	name 		  CDATA 						#REQUIRED
+<!ATTLIST typedef
+	name 		  CDATA 						        #REQUIRED
 	type 		  (%DefinableDataTypes;) 		#IMPLIED
-	size 		  CDATA 						#IMPLIED
-	pattern 	CDATA 						#IMPLIED
-	minimum 	CDATA 						#IMPLIED
-	maximum 	CDATA 						#IMPLIED>
+	size 		  CDATA 						        #IMPLIED
+	pattern 	CDATA 						        #IMPLIED
+	minimum 	CDATA 						        #IMPLIED
+	maximum 	CDATA 						        #IMPLIED>
 
 <!--
   information about how to translate a type into types known to different target
-  languages. TODO: Once again I'm not wholly comfortable with the name; I'm not 
+  languages. TODO: Once again I'm not wholly comfortable with the name; I'm not
   really comfortable that this belongs in ADL at all.
-  
+
   target:     the target language
   value:      the type to use in that target language
-  kind:       OK, I confess I don't understand this, but Andrew needs it... 
+  kind:       OK, I confess I don't understand this, but Andrew needs it...
 -->
 <!ELEMENT in-implementation (documentation?)>
 
@@ -232,28 +232,28 @@ that we can allow HTML block level entities within content elements -->
       value   CDATA           #REQUIRED
       kind    CDATA           #IMPLIED>
 
-<!-- 
-  a group of people with similar permissions to one another 
-  
+<!--
+  a group of people with similar permissions to one another
+
   name: the name of this group
   parent: the name of a group of which this group is subset
   -->
 <!ELEMENT group (documentation?)>
 
-<!ATTLIST group 
+<!ATTLIST group
   name      CDATA             #REQUIRED
   parent    CDATA             #IMPLIED>
 
 
 
-<!-- 
+<!--
 	an entity which has properties and relationships; maps onto a database
 	table or a Java serialisable class - or, of course, various other things
-  
+
   name:         obviously, the name of this entity
   natural-key:  if present, the name of a property of this entity which forms
                 a natural primary key [NOTE: Only partly implemented. NOTE: much of
-                the present implementation assumes all primary keys will be 
+                the present implementation assumes all primary keys will be
                 integers. This needs to be fixed!] DEPRECATED: remove; replace with the
                 'key' element, below.
   table:        the name of the table in which this entity is stored. Defaults to same
@@ -264,13 +264,13 @@ that we can allow HTML block level entities within content elements -->
 -->
 <!ELEMENT entity ( documentation?, prompt*, content?, key?,
       property*, permission*, (form | page | list)*)>
-<!ATTLIST entity 
+<!ATTLIST entity
     name      CDATA           #REQUIRED
     natural-key CDATA         #IMPLIED
     table     CDATA           #IMPLIED
     foreign   %Boolean;       #IMPLIED>
 
-<!-- 
+<!--
   contains documentation on the element which immediately contains it. TODO:
   should HTML markup within a documentation element be allowed? If so, are
   there restrictions?
@@ -284,33 +284,33 @@ that we can allow HTML block level entities within content elements -->
 <!ELEMENT key (property*)>
 
 
-<!-- 
-	a property (field) of an entity (table) 
-	
+<!--
+	a property (field) of an entity (table)
+
 	name:			  the name of this property.
 	type:			  the type of this property.
-	default:		the default value of this property. There will probably be 
+	default:		the default value of this property. There will probably be
 					    magic values of this!
 	typedef:	  name of the typedef to use, it type = 'defined'.
-	distinct:		distinct='system' required that every value in the system 
+	distinct:		distinct='system' required that every value in the system
 					    will be distinct (i.e. natural primary key);
-					    distinct='user' implies that the value may be used by users 
-					    in distinguishing entities even if values are not formally 
-					    unique; 
-					    distinct='all' implies that the values are formally unique 
+					    distinct='user' implies that the value may be used by users
+					    in distinguishing entities even if values are not formally
+					    unique;
+					    distinct='all' implies that the values are formally unique
 					    /and/ are user friendly (NOTE: not implemented).
-	entity:	if type='entity', the name of the entity this property is 
+	entity:	if type='entity', the name of the entity this property is
 					    a foreign key link to.
-              if type='list', the name of the entity that has a foreign 
+              if type='list', the name of the entity that has a foreign
               key link to this entity
-	farkey:   if type='list', the name of farside key in the listed 
-              entity; if type='entity' and the farside field to join to 
+	farkey:   if type='list', the name of farside key in the listed
+              entity; if type='entity' and the farside field to join to
               is not the farside primary key, then the name of that
               farside field
 	required:		whether this propery is required (i.e. 'not null').
 	immutable:		if true, once a value has been set it cannot be changed.
 	size: 			fieldwidth of the property if specified.
-	concrete: if set to 'false', this property is not stored in the 
+	concrete: if set to 'false', this property is not stored in the
               database but must be computed (manually written code must
               be provided to support this)
 	cascade:  what action(s) on the parent entity should be cascaded to
@@ -319,13 +319,13 @@ that we can allow HTML block level entities within content elements -->
 	column:   name of the column in a SQL database table in which this property
               is stored. TODO: Think about this.
 	unsaved-value:
-              of a property whose persistent value is set on first being 
+              of a property whose persistent value is set on first being
               committed to persistent store, the value which it holds before
               it has been committed
 -->
 <!ELEMENT property ( documentation?, generator?, (permission|option|prompt|help|ifmissing)*)>
 
-<!ATTLIST property 
+<!ATTLIST property
 	name 		    CDATA 					#REQUIRED
 	type 		    (%AllDataTypes;)		#REQUIRED
 	default 		CDATA 					#IMPLIED
@@ -334,24 +334,24 @@ that we can allow HTML block level entities within content elements -->
 	entity 			CDATA 					#IMPLIED
 	farkey			CDATA					#IMPLIED
  	required 		%Boolean; 				#IMPLIED
-	immutable		%Boolean;				#IMPLIED	
+	immutable		%Boolean;				#IMPLIED
 	size 		    CDATA 					#IMPLIED
 	column			CDATA					#IMPLIED
 	concrete		%Boolean;				#IMPLIED
 	cascade			(%CascadeActions;)		#IMPLIED>
 
 
-<!-- 
-  marks a property which is auto-generated by some part of the system. 
-  This is based on the Hibernate construct, except that the Hibernate 
-  implementation folds both its internal generators and custom generators 
-  onto the same attribute. This separates them onto two attributes so we 
+<!--
+  marks a property which is auto-generated by some part of the system.
+  This is based on the Hibernate construct, except that the Hibernate
+  implementation folds both its internal generators and custom generators
+  onto the same attribute. This separates them onto two attributes so we
   can police values for Hibernate's 'builtin' generators.
-  
-  action:       one of the supported Hibernate builtin generators, or 
+
+  action:       one of the supported Hibernate builtin generators, or
                 'manual'. 'native' is strongly recommended in most instances
-  class:        if action is 'manual', the name of a manually maintained 
-                class conforming to the Hibernate IdentifierGenerator 
+  class:        if action is 'manual', the name of a manually maintained
+                class conforming to the Hibernate IdentifierGenerator
                 interface, or its equivalent in other languages
 -->
 <!ELEMENT generator (documentation?, param*)>
@@ -360,15 +360,15 @@ that we can allow HTML block level entities within content elements -->
       class   CDATA                   #IMPLIED>
 
 <!--
-  A parameter passed to the generator. Again, based on the Hibernate 
+  A parameter passed to the generator. Again, based on the Hibernate
   implementation. TODO: #PCDATA is wrong as the content model, as embedded
   markup is definitely not allowed!
-  
+
   name:   the name of this parameter
-  
+
   TODO: This needs to be renamed or removed because it conflicts with the
-  XHTML element of the same name. In fact it could be simply removed since 
-  our usage is compatible with the XHTML usage, but it might be less 
+  XHTML element of the same name. In fact it could be simply removed since
+  our usage is compatible with the XHTML usage, but it might be less
   ambiguous to rename it.
 -->
 <!ELEMENT param (#PCDATA)>
@@ -377,40 +377,40 @@ that we can allow HTML block level entities within content elements -->
 
 
 
-<!-- 
-	one of an explicit list of optional values a property may have 
-	NOTE: whether options get encoded at application layer or at database layer 
-	is UNDEFINED; either behaviour is correct. If at database layer it's also 
-	UNDEFINED whether they're encoded as a single reference data table or as 
+<!--
+	one of an explicit list of optional values a property may have
+	NOTE: whether options get encoded at application layer or at database layer
+	is UNDEFINED; either behaviour is correct. If at database layer it's also
+	UNDEFINED whether they're encoded as a single reference data table or as
 	separate reference data tables for each property.
-	
+
 	value:	the value of this option
 
 	TODO: This needs to be renamed or removed because it conflicts with the
-	XHTML element of the same name. In fact it could be simply removed since 
-	our usage is compatible with the XHTML usage, but it might be less 
+	XHTML element of the same name. In fact it could be simply removed since
+	our usage is compatible with the XHTML usage, but it might be less
 	ambiguous to rename it.
 -->
 <!ELEMENT option (documentation?, prompt*)>
 <!-- if the value is different from the prompt the user sees, specify it -->
-<!ATTLIST option 
+<!ATTLIST option
   value       CDATA           #IMPLIED>
 
 
-<!-- 
-	permissions policy on an entity, a page, form, list or field 
-	
+<!--
+	permissions policy on an entity, a page, form, list or field
+
 	group: 			the group to which permission is granted
 	permission:		the permission which is granted to that group
 -->
 <!ELEMENT permission (documentation?)>
-<!ATTLIST permission 
+<!ATTLIST permission
 	group 		  CDATA 					#REQUIRED
 	permission 	(%Permissions;) #REQUIRED>
 
 
 <!--
-  pragmatic advice to generators of lists and forms, in the form of 
+  pragmatic advice to generators of lists and forms, in the form of
   name/value pairs which may contain anything. Over time some pragmas
   will become 'well known', but the whole point of having a pragma
   architecture is that it is extensible.
@@ -420,27 +420,27 @@ that we can allow HTML block level entities within content elements -->
   name        CDATA           #REQUIRED
   value       CDATA           #REQUIRED>
 
-<!-- 
-	a prompt for a property or field; used as the prompt text for a widget 
+<!--
+	a prompt for a property or field; used as the prompt text for a widget
 	which edits it. Typically there will be only one of these per property
   per locale; if there are more than one all those matching the locale may
   be concatenated, or just one may be used.
-	
+
 	prompt:			the prompt to use
-	locale:			the locale in which to prefer this prompt	
+	locale:			the locale in which to prefer this prompt
 -->
 <!ELEMENT prompt (documentation?)>
 <!ATTLIST prompt
 	prompt		  CDATA				  	#REQUIRED
 	locale		  %Locale;				#REQUIRED >
 
-<!-- 
-	helptext about a property of an entity, or a field of a page, form or 
+<!--
+	helptext about a property of an entity, or a field of a page, form or
 	list, or a typedef. Typically there will be only one of these per property
   per locale; if there are more than one all those matching the locale may
   be concatenated, or just one may be used.
 
-	locale:			the locale in which to prefer this prompt	
+	locale:			the locale in which to prefer this prompt
 -->
 <!ELEMENT help (#PCDATA)>
 <!ATTLIST help
@@ -448,7 +448,7 @@ that we can allow HTML block level entities within content elements -->
   xmlns     CDATA             #IMPLIED >
 
 <!--
-  helpful text to be shown if a property value is missing, typically when 
+  helpful text to be shown if a property value is missing, typically when
   a form is submitted. Typically there will be only one of these per property
   per locale; if there are more than one all those matching the locale may
   be concatenated, or just one may be used. Later there may be more sophisticated
@@ -462,7 +462,7 @@ that we can allow HTML block level entities within content elements -->
 <!-- a form through which an entity may be added or edited
 
   TODO: This needs to be renamed because it conflicts with the
-  XHTML element of the same name. 
+  XHTML element of the same name.
 -->
 <!ELEMENT form (documentation?, ( %PageStuff;)*)>
 <!ATTLIST form %PageAttrs;>
@@ -472,7 +472,7 @@ that we can allow HTML block level entities within content elements -->
 <!ELEMENT page (documentation?, ( %PageStuff;)*)>
 <!ATTLIST page %PageAttrs;>
 
-<!-- an ordering or records in a list 
+<!-- an ordering or records in a list
 	property:	the property on which to order
 	sequence:	the sequence in which to order
 -->
@@ -481,11 +481,11 @@ that we can allow HTML block level entities within content elements -->
       property  CDATA       #REQUIRED
       sequence  (%Sequences;)  #IMPLIED>
 
-<!-- 
+<!--
 	a list on which entities of a given type are listed
 
 	onselect:		name of form/page/list to go to when
-					    a selection is made from the list 
+					    a selection is made from the list
 -->
 <!ELEMENT list (documentation?, ( %PageStuff;|order)*)>
 <!ATTLIST list %PageAttrs;
@@ -495,7 +495,7 @@ that we can allow HTML block level entities within content elements -->
 <!--
   a subsidiary list, on which entities related to primary
   entities in the enclosing page or list are listed
-  
+
   property:   the property of the enclosing entity that this
               list displays (obviously, must be of type='list')
   onselect:   the form or page of the listed entity to call
@@ -510,7 +510,7 @@ that we can allow HTML block level entities within content elements -->
   canadd      %Boolean;       #IMPLIED>
 
 <!--
-  a group of fields and other controls within a form or list, which the 
+  a group of fields and other controls within a form or list, which the
   renderer might render as a single pane in a tabbed display, for example.
   -->
 <!ELEMENT fieldgroup (documentation?, (prompt|permission|%FieldStuff;)*)>
@@ -523,10 +523,10 @@ that we can allow HTML block level entities within content elements -->
   property:   the property which this field displays/edits
   -->
 <!ELEMENT field (documentation?, (prompt|help|permission)*) >
-<!ATTLIST field 
+<!ATTLIST field
   property    CDATA           #REQUIRED >
 
-<!-- a verb is something that may be done through a form. Probably the verbs 'store' 
+<!-- a verb is something that may be done through a form. Probably the verbs 'store'
   and 'delete' are implied, but maybe they need to be explicitly declared. The 'verb'
   attribute of the verb is what gets returned to the controller -->
 <!ELEMENT verb (documentation?, (prompt|help|permission)*) >
@@ -539,14 +539,14 @@ that we can allow HTML block level entities within content elements -->
 <!ELEMENT content (%Content;)*>
 
 
-<!-- 
-	content to place in the head of the generated document; this is #PCDATA 
-	because it will almost certainly belong to a different namespace 
+<!--
+	content to place in the head of the generated document; this is #PCDATA
+	because it will almost certainly belong to a different namespace
 	(usually HTML)
 
 	TODO: This needs to be renamed or removed because it conflicts with the
-	XHTML element of the same name. In fact it could be simply removed since 
-	our usage is compatible with the XHTML usage, but it might be less 
+	XHTML element of the same name. In fact it could be simply removed since
+	our usage is compatible with the XHTML usage, but it might be less
 	ambiguous to rename it.
 -->
 <!ELEMENT head (#PCDATA) >
@@ -554,30 +554,30 @@ that we can allow HTML block level entities within content elements -->
   xmlns     CDATA             #IMPLIED>
 
 
-<!-- 
-	content to place in the top of the body of the generated document; 
+<!--
+	content to place in the top of the body of the generated document;
 	this is %Flow; which is any HTML block or inline level element.
 -->
 <!ELEMENT top (#PCDATA) >
 <!ATTLIST top
   xmlns     CDATA             #IMPLIED>
 
-<!-- 
-	content to place at the foot of the body of the generated document; 
+<!--
+	content to place at the foot of the body of the generated document;
 	this is %Flow; which is any HTML block or inline level element.
 -->
 <!ELEMENT foot (#PCDATA) >
 <!ATTLIST foot
   xmlns     CDATA             #IMPLIED>
 
-<!-- 
+<!--
 	The 'specification' and 'reference' elements are for documentation only,
 	and do not contribute to the engineering of the application described.
-	
+
 	A specification element is intended chiefly to declare the reference
-	documents which may be used in documentation elements later in the 
-	document. 
-	
+	documents which may be used in documentation elements later in the
+	document.
+
 	url:		The URL from which the document referenced can be retrieved
 	name:		The full name (title) given to this document
 	abbr:		A convenient abbreviated name
@@ -589,12 +589,12 @@ that we can allow HTML block level entities within content elements -->
 		abbr		CDATA	#REQUIRED
 		>
 
-<!-- 
+<!--
 	The 'specification' and 'reference' elements are for documentation only,
 	and do not contribute to the engineering of the application described.
-	
-	A reference element is a reference to a specifying document. 
-	
+
+	A reference element is a reference to a specifying document.
+
 	abbr:		The abbreviated name of the specification to which this
 				reference refers
 	section:	The 'anchor part' (part following a hash character) which,
