Add comment about glossary

README.html

@@ -749,7 +749,7 @@ Not feas*ible*.
 </div>
 </div>
 <div id="outline-container-orgheadline27" class="outline-3">
-<h3 id="orgheadline27">Definition lists</h3>
+<h3 id="orgheadline27"><a id="ID-f1a4a242-755b-4c38-9280-ee3f60e2b29a" name="ID-f1a4a242-755b-4c38-9280-ee3f60e2b29a"></a>Definition lists</h3>
 <div class="outline-text-3" id="text-orgheadline27">
 <p>Labeled, multi-line lists.</p>
 <div class="org-src-container">
@@ -2426,7 +2426,9 @@ digraph <span class="org-function-name">foo</span> {
 </div>
 <div id="outline-container-orgheadline90" class="outline-2">
 <h2 id="orgheadline90">Appendix</h2>
-<div class="outline-text-2" id="text-orgheadline90"></div>
+<div class="outline-text-2" id="text-orgheadline90">
+<p>Special sections.</p>
+</div>
 <div id="outline-container-orgheadline91" class="outline-3">
 <h3 id="orgheadline91">Index</h3>
 <div class="outline-text-3" id="text-orgheadline91">
@@ -2434,6 +2436,7 @@ digraph <span class="org-function-name">foo</span> {
 <ul class="org-ul">
 <li>Write index entries</li>
 </ul>
+<p>Note that multi-entry terms generate separate index entries.</p>
 <ul class="org-ul">
 <li>Place the index at the desired location</li>
 <li>Produce the index by updating <code>org-latex-pdf-process</code></li>
@@ -2452,7 +2455,7 @@ digraph <span class="org-function-name">foo</span> {
 <div id="outline-container-orgheadline93" class="outline-3">
 <h3 id="orgheadline93">Glossary</h3>
 <div class="outline-text-3" id="text-orgheadline93">
-<p>Glossaries are optional.</p>
+<p>Glossaries are optional. Glossaries entries are an example of <a href="#orgheadline27">definition lists</a>.</p>
 <dl class="org-dl">
 <dt>A glossary term</dt>
 <dd>The corresponding (indented) definition.</dd>

README.org

@@ -317,6 +317,9 @@ You can have ordered lists with jumping numbers:
 #+end_src
 
 ** Definition lists
+   :PROPERTIES:
+   :ID:       f1a4a242-755b-4c38-9280-ee3f60e2b29a
+   :END:
 
 Labeled, multi-line lists.
 
@@ -1480,6 +1483,8 @@ Cross-referenced to bibliography.
 
 * Appendix
 
+Special sections.
+
 ** Index
 
 Index (or list of acronyms).
@@ -1487,6 +1492,9 @@ Index (or list of acronyms).
 - Write index entries
 
 #+index: Org-mode
+
+  Note that multi-entry terms generate separate index entries.
+
 #+index: Definitions!Org-mode
 
 - Place the index at the desired location
@@ -1506,7 +1514,7 @@ The bibliography...
 
 ** Glossary
 
-Glossaries are optional.
+Glossaries are optional.  Glossaries entries are an example of [[id:f1a4a242-755b-4c38-9280-ee3f60e2b29a][definition lists]].
 
 - A glossary term ::
      The corresponding (indented) definition.