summaryrefslogtreecommitdiff
path: root/docs/dev/testing.txt
diff options
context:
space:
mode:
Diffstat (limited to 'docs/dev/testing.txt')
-rw-r--r--docs/dev/testing.txt9
1 files changed, 8 insertions, 1 deletions
diff --git a/docs/dev/testing.txt b/docs/dev/testing.txt
index dbf50dcee..6336f16e7 100644
--- a/docs/dev/testing.txt
+++ b/docs/dev/testing.txt
@@ -252,7 +252,7 @@ reader, parser and writer.
Now run ``test_functional.py``. The test will fail, of course,
because you do not have an expected output yet. However, an output
file will have been generated in ``functional/output/``. Check this
-output file for validity and correctness. Then copy the file to
+output file for validity [#]_ and correctness. Then copy the file to
``functional/expected/``.
If you rerun ``test_functional.py`` now, it should pass.
@@ -265,6 +265,13 @@ actual output for validity and correctness, copy it to
``functional/expected/`` (overwriting the old expected output), and
commit the change.
+.. [#] The validity of `Docutils XML` can be tested with
+ ``xmllint <document-referencing-local-Docutils-DTD>.xml --valid --noout``.
+
+ .. note: the ``--dtdvalid`` and ``--nonet`` options did not help override
+ a reference to the PUBLIC "docutils.dtd" if there is a local version
+ on the system (e.g. /usr/share/xml/docutils/docutils.dtd in Debian).
+
.. _default configuration file: