[Docutils-checkins] SF.net SVN: docutils:[8059] trunk/docutils

[<mi...@us...>]

Revision: 8059
          http://sourceforge.net/p/docutils/code/8059
Author:   milde
Date:     2017-04-19 16:47:35 +0000 (Wed, 19 Apr 2017)
Log Message:
-----------
Documentation update.

Modified Paths:
--------------
    trunk/docutils/docs/user/config.txt
    trunk/docutils/test/data/dependencies.txt
    trunk/docutils/test/data/raw.txt
    trunk/docutils/test/test_dependencies.py

Modified: trunk/docutils/docs/user/config.txt
===================================================================
--- trunk/docutils/docs/user/config.txt	2017-04-19 16:45:32 UTC (rev 8058)
+++ trunk/docutils/docs/user/config.txt	2017-04-19 16:47:35 UTC (rev 8059)
@@ -678,7 +678,8 @@
 smart_quotes
 ~~~~~~~~~~~~
 
-Change straight quotation marks to typographic form. `Quote characters`_
+Activate the SmartQuotes_ transform to
+change straight quotation marks to typographic form. `Quote characters`_
 are selected according to the language of the current block element (see
 language_code_). Also changes consequtive runs of hyphen-minus and full
 stops (``---``, ``--``, ``...``) to em-dash, en-dash and ellipsis Unicode
@@ -696,6 +697,7 @@
 
 New in Docutils 0.10.
 
+.. _SmartQuotes: smartquotes.html
 .. _quote characters:
    http://en.wikipedia.org/wiki/Non-English_usage_of_quotation_marks
 
@@ -786,10 +788,10 @@
 (`[restructuredtext parser]`_) are set on by default.
 
 
-[python reader]
----------------
+.. [python reader]
+   ---------------
 
-Not implemented.
+   Not implemented.
 
 
 [writers]
@@ -954,7 +956,7 @@
 :HTML:
   Format math in standard HTML enhanced by CSS rules.
   Requires the ``math.css`` stylesheet (in the system
-  `stylesheet directory <stylesheet_dirs [html4css1 writer]_>`_
+  `stylesheet directory <stylesheet_dirs [html4css1 writer]_>`_)
 
   A `stylesheet_path <stylesheet_path [html4css1 writer]_>`_
   can be appended after whitespace, the specified
@@ -975,8 +977,8 @@
     __ http://docs.mathjax.org/en/latest/tex.html#supported-latex-commands
 
   Con:
-    Requires an Internet connection (or a local MathJax
-    installation and configuration).
+    Requires an Internet connection or a local MathJax
+    installation and configuration.
 
     Downloads JavaScript code from a third-party site.
 

Modified: trunk/docutils/test/data/dependencies.txt
===================================================================
--- trunk/docutils/test/data/dependencies.txt	2017-04-19 16:45:32 UTC (rev 8058)
+++ trunk/docutils/test/data/dependencies.txt	2017-04-19 16:47:35 UTC (rev 8059)
@@ -27,3 +27,11 @@
 
 .. image:: ../docs/user/rst/images/biohazard.png
    :scale: 50 %
+
+TODO: Paths in included files should be rewritten relative to the base
+      document.
+
+      * when loading images,
+      * when recording dependencies.
+
+.. include: subdir/dependencies-included.txt

Modified: trunk/docutils/test/data/raw.txt
===================================================================
--- trunk/docutils/test/data/raw.txt	2017-04-19 16:45:32 UTC (rev 8058)
+++ trunk/docutils/test/data/raw.txt	2017-04-19 16:47:35 UTC (rev 8059)
@@ -0,0 +1 @@
+Raw text.

Modified: trunk/docutils/test/test_dependencies.py
===================================================================
--- trunk/docutils/test/test_dependencies.py	2017-04-19 16:45:32 UTC (rev 8058)
+++ trunk/docutils/test/test_dependencies.py	2017-04-19 16:47:35 UTC (rev 8059)
@@ -74,7 +74,7 @@
         self.assertEqual(record, expected)
 
     def test_dependencies_latex(self):
-        # since 0.9, the latex writer records only really accessed files, too
+        # since 0.9, the latex writer records only really accessed files, too.
         # Note: currently, raw input files are read (and hence recorded) while
         # parsing even if not used in the chosen output format.
         # This should change (see parsers/rst/directives/misc.py).

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.