[Docutils-checkins] r3622 - in trunk/docutils/docs/ref: doctree.txt docutils.dtd

[<fel...@us...>]

Author: felixwiemann
Date: 2005-06-29 14:09:04 +0200 (Wed, 29 Jun 2005)
New Revision: 3622

Modified:
   trunk/docutils/docs/ref/doctree.txt
   trunk/docutils/docs/ref/docutils.dtd
Log:
added "title" attribute to document tree reference

Modified: trunk/docutils/docs/ref/doctree.txt
===================================================================
--- trunk/docutils/docs/ref/doctree.txt	2005-06-29 11:26:25 UTC (rev 3621)
+++ trunk/docutils/docs/ref/doctree.txt	2005-06-29 12:09:04 UTC (rev 3622)
@@ -1785,10 +1785,13 @@
 of a ``document``.
 
 :Attributes:
-    The ``document`` element contains only the `common attributes`_:
-    id_, name_, dupname_, source_, and class_.
+    The ``document`` element contains the `common attributes`_ (id_,
+    name_, dupname_, source_, and class_), plus an optional title__
+    attribute which stores the document title metadata.
 
+    __ `title (attribute)`_
 
+
 Examples
 --------
 
@@ -3975,6 +3978,8 @@
             15% if the service is good.
 
 
+.. _title:
+
 ``title``
 =========
 
@@ -4577,6 +4582,18 @@
 instance.
 
 
+.. _title (attribute):
+
+``title``
+=========
+
+`Attribute type`_: ``CDATA``.  Default value: none.
+
+The ``title`` attribute stores the title metadata of a document.  This
+title is typically not part of the rendered document.  It may for
+example be used in HTML's ``title`` element.
+
+
 ----------------------------
  Parameter Entity Reference
 ----------------------------

Modified: trunk/docutils/docs/ref/docutils.dtd
===================================================================
--- trunk/docutils/docs/ref/docutils.dtd	2005-06-29 11:26:25 UTC (rev 3621)
+++ trunk/docutils/docs/ref/docutils.dtd	2005-06-29 12:09:04 UTC (rev 3622)
@@ -196,7 +196,9 @@
       decoration?,
       (docinfo, transition?)?,
       %structure.model; )>
-<!ATTLIST document %basic.atts;>
+<!ATTLIST document
+    %basic.atts;
+    title     CDATA     #IMPLIED>
 
 <!--
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~