[Docutils-checkins] SF.net SVN: docutils:[10269] trunk/docutils/RELEASE-N OTES.rst

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

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.