Emphasized the DocTitle transfrom in docs, as it's a very FAQ.

git-svn-id: http://svn.code.sf.net/p/docutils/code/trunk@2101 929543f6-e4f2-0310-98a6-ba3bd3dd1d04

1 files changed, 7 insertions, 0 deletions

diff --git a/docutils/docs/user/rst/quickref.html b/docutils/docs/user/rst/quickref.html
index 6998e244c..64512058d 100644
--- a/docutils/docs/user/rst/quickref.html
+++ b/docutils/docs/user/rst/quickref.html
@@ -279,6 +279,10 @@
 <br><samp>are&nbsp;"``=&nbsp;-&nbsp;`&nbsp;:&nbsp;'&nbsp;"&nbsp;~&nbsp;^&nbsp;_&nbsp;*&nbsp;+&nbsp;#&nbsp;&lt;&nbsp;&gt;``".</samp>
 <br><samp>The&nbsp;underline/overline&nbsp;must&nbsp;be&nbsp;at</samp>
 <br><samp>least&nbsp;as&nbsp;long&nbsp;as&nbsp;the&nbsp;title&nbsp;text.</samp>
+<br><samp></samp>
+<br><samp>A&nbsp;lone&nbsp;top-level&nbsp;(sub)section</samp>
+<br><samp>is&nbsp;lifted&nbsp;up&nbsp;to&nbsp;be&nbsp;the&nbsp;document's</samp>
+<br><samp>(sub)title.</samp>
 
       <td>
         <font size="+2"><strong>Title</strong></font>
@@ -290,6 +294,9 @@
           are "<samp>= - ` : ' " ~ ^ _ * + # &lt; &gt;</samp>".
           The underline/overline must be at
           least as long as the title text.
+        <p>A lone top-level (sub)section is
+          lifted up to be the document's
+          (sub)title.
     </table>
 
     <h2><a href="#contents" name="paragraphs" class="backref"