Documentation fix.

Fix internal links in "directives" doc.
Add links to description of differences between html4css1 and html5 writers.

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

1 files changed, 6 insertions, 4 deletions

diff --git a/docutils/docs/ref/rst/directives.txt b/docutils/docs/ref/rst/directives.txt
index 3cf29e3b7..ed2cc919e 100644
--- a/docutils/docs/ref/rst/directives.txt
+++ b/docutils/docs/ref/rst/directives.txt
@@ -361,7 +361,7 @@ In addition, the following options are recognized:
 
 ``figclass`` : space separated list of `class names`_
     Set a `"classes"`_ attribute value on the figure element.  See the
-    class_ directive below.
+    `class directive`_ below.
 
 .. _Python Imaging Library:
 .. _Pillow: https://pypi.org/project/Pillow/
@@ -1100,7 +1100,7 @@ The following options are recognized:
 
 ``class`` : text_ (list of `class names`_)
     Set a `"classes"`_ attribute value on the topic element.  See the
-    class_ directive below.
+    `class directive`_ below.
 
 
 .. _sectnum:
@@ -1609,6 +1609,8 @@ and the common option class_.
 .. _"raw" role: roles.html#raw
 
 
+.. _class directive:
+
 Class
 =====
 
@@ -1846,7 +1848,7 @@ base roles:
     (``inline``, or element associated with a base class) when the
     custom interpreted text role is used.  If no directive options are
     specified, a "class" option with the directive argument (role
-    name) as the value is implied.  See the class_ directive above.
+    name) as the value is implied.  See the `class directive`_ above.
 
 Specific base roles may support other options and/or directive
 content.  See the `reStructuredText Interpreted Text Roles`_ document
@@ -2023,7 +2025,7 @@ options:
 
 ``class`` : space separated list of `class names`_
     Set a `"classes"`_ attribute value on the doctree element generated by
-    the directive. See also the class_ directive.
+    the directive. See also the `class directive`_.
 
     .. _name: