Added reference.xml auto-generation from dtdxml

This should have been an established process, but for some reason it was
edited manually after initial generation.

After the change `reference.xml` can be removed from the repository, but
I left it to show that the things are working fine and the difference from
an auto-generated one are simple divergences due to manual changing
(not updated `reference.xml` with added `<purpose>` elements in 38017203f69cec3aa5f402fe8306eb1deff67b9a). Also removed the date numbers
from `dtdxml` as they were never in `xml` and seems to have no actual use,
but brings a lot of noise to `xml` differences after added auto-generation.

doc/Jamfile.v2

@@ -7,7 +7,11 @@
 project boostbook/doc ;
 import boostbook : boostbook ;
 
+xml reference : reference.dtdxml : <location>. ;
+explicit reference ;
+
 boostbook boostbook : boostbook.xml :
     <xsl:param>boost.root=../../../..
+    <dependency>reference
     ;
 

doc/reference.dtdxml

@@ -11,7 +11,7 @@
      created-on="Wed Feb 18 23:39:45 2009"
 >
 <attpurpose name="id">A global identifier for this element</attpurpose>
-<attpurpose name="last-revision">Set to $Date: 2003/04/13 14:46:07 $ to keep "last revised" information in sync with CVS changes</attpurpose>
+<attpurpose name="last-revision">Set to $Date$ to keep "last revised" information in sync with CVS changes</attpurpose>
 <attpurpose name="xml:base">Implementation detail used by XIncludes</attpurpose>
 <attpurpose name="name">The name of the element being declared to referenced</attpurpose>
 <attpurpose name="filename">The name of the file associated with this element</attpurpose>

doc/reference.xml

@@ -5,6 +5,8 @@
    Distributed under the Boost Software License, Version 1.0.
    (See accompanying file LICENSE_1_0.txt or copy at
    http://www.boost.org/LICENSE_1_0.txt)
+
+   This file is automatically generated by dtd2boostbook.xsl
 -->
 <chapter id="reference">
   <title>Reference</title>
@@ -735,7 +737,7 @@
     </refmeta>
     <refnamediv>
       <refname>macroname</refname>
-      <refpurpose/>
+      <refpurpose>References a macro with the given name</refpurpose>
     </refnamediv>
     <refsynopsisdiv>macroname ::= 
   (#PCDATA)
@@ -1031,7 +1033,7 @@
     </refmeta>
     <refnamediv>
       <refname>headername</refname>
-      <refpurpose/>
+      <refpurpose>References a C++ header with the given name</refpurpose>
     </refnamediv>
     <refsynopsisdiv>headername ::= 
   (#PCDATA)
@@ -1396,7 +1398,7 @@
     </refmeta>
     <refnamediv>
       <refname>globalname</refname>
-      <refpurpose/>
+      <refpurpose>References a global with the given name</refpurpose>
     </refnamediv>
     <refsynopsisdiv>globalname ::= 
   (#PCDATA)
@@ -2549,7 +2551,7 @@
     </refmeta>
     <refnamediv>
       <refname>enumname</refname>
-      <refpurpose/>
+      <refpurpose>References an enumeration type with the given name</refpurpose>
     </refnamediv>
     <refsynopsisdiv>enumname ::= 
   (#PCDATA)
@@ -2948,4 +2950,3 @@
     </refsection>
   </refentry>
 </chapter>
-