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, 9 insertions, 1 deletions

diff --git a/docutils/docs/user/html.txt b/docutils/docs/user/html.txt
index df151ae5e..b18a0da0e 100644
--- a/docutils/docs/user/html.txt
+++ b/docutils/docs/user/html.txt
@@ -101,6 +101,9 @@ html5
 The ``html5_polyglot`` writer generates `polyglot HTML`_ [#]_ output, valid
 XML [#safetext]_ that is compatible with `HTML5`_. New features and elements
 are used if they are widely supported.
+See the `HTML5 test page`_ (and the sources `html5-features.txt`_ and
+`html5-text-level-tags.txt`_) for further differences to the html4css1_
+writer.
 
 There is no hard-coded formatting information in the HTML document.
 Correct rendering of elements not directly supported by HTML depends on a
@@ -114,7 +117,12 @@ New in Docutils 0.13
 .. [#] see also `Benefits of polyglot XHTML5`_
 .. [#safetext] The validity of raw HTML and custom stylesheets must be
    ensured by the author.
-
+.. _HTML5 test page: https://docutils.sourceforge.io/test/functional/
+    expected/standalone_rst_html5.html#changes-to-the-html4css1-writer
+.. _html5-features.txt: https://docutils.sourceforge.io/test/functional/
+    input/data/html5-features.txt
+.. _html5-text-level-tags.txt: https://docutils.sourceforge.io/test/functional/
+    input/data/html5-text-level-tags.txt
 .. _rst2html5.py: tools.html#rst2html5-py
 .. _[html5 writer]: config.html#html5-writer
 .. _minimal.css: ../../docutils/writers/html5_polyglot/minimal.css