summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authormilde <milde@929543f6-e4f2-0310-98a6-ba3bd3dd1d04>2023-02-06 21:34:19 +0000
committermilde <milde@929543f6-e4f2-0310-98a6-ba3bd3dd1d04>2023-02-06 21:34:19 +0000
commite697241c979603e828902177436c0b483ee780c8 (patch)
treeaad80cecdf0ed02e718c3ec3b53e86190dffe9c9
parentcd03b1f0575deb1fa36a9cd07e2230b156a6c053 (diff)
downloaddocutils-e697241c979603e828902177436c0b483ee780c8.tar.gz
Update documentation on planned changes.
Announce target versions for imminent changes. Announce raise of required minimal Python version to 3.9. git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk@9326 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
-rw-r--r--docutils/HISTORY.txt7
-rw-r--r--docutils/RELEASE-NOTES.txt16
-rw-r--r--docutils/docs/user/config.txt6
3 files changed, 20 insertions, 9 deletions
diff --git a/docutils/HISTORY.txt b/docutils/HISTORY.txt
index 20e79dc21..9f5fb4e97 100644
--- a/docutils/HISTORY.txt
+++ b/docutils/HISTORY.txt
@@ -13,12 +13,13 @@
.. contents::
-Changes Since 0.19
-==================
+Release 0.20b (unpublished)
+===========================
* General
- - Support Python 3.11 (patch #198 by Hugo van Kemenade).
+ - Docutils 0.20 is the last version supporting Python 3.7 and 3.8.
+ - Support Python 3.11 (patch #198 by Hugo van Kemenade).
* docutils/core.py
diff --git a/docutils/RELEASE-NOTES.txt b/docutils/RELEASE-NOTES.txt
index 67c7c5638..29d32f140 100644
--- a/docutils/RELEASE-NOTES.txt
+++ b/docutils/RELEASE-NOTES.txt
@@ -20,6 +20,8 @@ For a more detailed list of changes, please see the Docutils `HISTORY`_.
Future changes
==============
+Drop support for Python 2.7 and 2.8 in Docutils 0.21.
+
* Usage:
- Docutils 0.21 will provide ``rst2*`` `"console_scripts" entry
@@ -67,14 +69,19 @@ Future changes
- Raise UnicodeError (instead of falling back to the locale encoding)
if decoding the source with the default encoding (UTF-8) fails and
- Python is started in `UTF-8 mode`_.
+ Python is started in `UTF-8 mode`_. (Docutils 0.21)
Raise UnicodeError (instead of falling back to "latin1") if both,
- default and locale encoding, fail.
+ default and locale encoding, fail. (Docutils 0.21)
- Only remove BOM (U+FEFF ZWNBSP at start of data), no other ZWNBSPs.
Only remove BOM with `input_encoding`_ values None, '', 'utf-8-sig',
- 'utf-16', and 'utf-32'.
+ 'utf-16', and 'utf-32'. (Docutils 0.21)
+
+ - Change the default input encoding from ``None`` (auto-detect) to
+ "utf-8" in Docutils 0.22.
+
+ - Remove the input encoding auto-detection code in Docutils 1.0.
* "html5" writer:
@@ -113,7 +120,8 @@ Future changes
* Drop support for `old-format configuration files`_ in Docutils 2.0.
-* Remove file ``install.py``. See README.txt__ for alternatives.
+* Remove file ``install.py`` in Docutils 0.21.
+ See README.txt__ for alternatives.
__ README.html#installation
diff --git a/docutils/docs/user/config.txt b/docutils/docs/user/config.txt
index 5fb6b3011..2be4d5550 100644
--- a/docutils/docs/user/config.txt
+++ b/docutils/docs/user/config.txt
@@ -100,7 +100,7 @@ recognized:
List values can be comma- or colon-delimited.
-strip_classes_, strip_elements_with_classes_, smartquotes_locales_,
+strip_classes_, strip_elements_with_classes_, smartquotes_locales_,
stylesheet, stylesheet_dirs, stylesheet_path, legacy_class_functions_,
and use_bibtex_ use the comma as delimiter,
whitespace around list values is stripped. ::
@@ -371,7 +371,9 @@ input_encoding
The text encoding for input (use the empty string to restore the default).
-Default: auto-detect_ (None). Options: ``--input-encoding, -i``.
+Default: auto-detect_ (None). [#]_ Options: ``--input-encoding, -i``.
+
+.. [#] The default will change to "utf-8" in Docutils 0.22.
.. _auto-detect: ../api/publisher.html#encodings