|
From: <mi...@us...> - 2025-12-02 19:48:51
|
Revision: 10269
http://sourceforge.net/p/docutils/code/10269
Author: milde
Date: 2025-12-02 19:48:48 +0000 (Tue, 02 Dec 2025)
Log Message:
-----------
Announce upcoming changes.
Modified Paths:
--------------
trunk/docutils/RELEASE-NOTES.rst
Modified: trunk/docutils/RELEASE-NOTES.rst
===================================================================
--- trunk/docutils/RELEASE-NOTES.rst 2025-12-02 19:48:42 UTC (rev 10268)
+++ trunk/docutils/RELEASE-NOTES.rst 2025-12-02 19:48:48 UTC (rev 10269)
@@ -71,6 +71,10 @@
The rST parser will handle a `doctest block`_ similar to a "code" directive
with language "pycon" (Python console) and generate a <literal_block>.
+* The `Transitions` transform will ignore <pending>,
+ <substitution_definition>, and <target> elements when warning about
+ transitions at the start or end of the document or a section.
+
Parsers
-------
@@ -77,6 +81,15 @@
* The "rst" parser will warn, if a directive that does not take arguments
has content above and below directive options in Docutils 0.23.
+* The highlight language of a custom role based on "code" will default to
+ its name in Docutils 0.23.
+
+* Problems with the "include" directive will be reported as ERROR instead
+ of SEVERE in Docutils 1.0.
+
+* The options :start-after: and :end-before: of the "include" directive
+ will support empty values (standing for an empty line).
+
* The "rst" parser will warn if a `"figure"`_ directive is missing both
caption and legend in Docutils 1.0.
@@ -104,6 +117,12 @@
__ docs/ref/rst/restructuredtext.html#explicit-hyperlink-targets
+ - Prefer explicit reference names as base for an HTML element's ID
+ in Docutils 1.0. No change for internal cross-references.
+ Cf. `Sphinx issue #1961`__
+
+ __ https://github.com/sphinx-doc/sphinx/issues/1961
+
- Move attribution behind the blockquote to comply with the
`"HTML living standard"`__ [#]_ and adapt CSS stylesheets
in Docutils 1.0.
@@ -110,7 +129,7 @@
__ https://html.spec.whatwg.org/#the-blockquote-element
- - Change the default value of the initial_header_level_ setting to None
+ - Change the default value of the initial_header_level_ setting to "auto"
(<h2> if there is a document title, else <h1>) in Docutils 1.0.
- Remove option ``--embed-images`` (obsoleted by "image_loading_")
@@ -242,12 +261,6 @@
Misc
----
-* Prefer explicit reference names as base for an HTML element's ID
- in Docutils 1.0. No change for internal cross-references.
- Cf. `Sphinx issue #1961`__
-
- __ https://github.com/sphinx-doc/sphinx/issues/1961
-
* Revise the `String I/O`__ interface used by the `publish_string()`
and `publish_from_doctree()` publisher convenience functions.
(In Python 3, name and behaviour no longer match.)
This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.
|