SF.net SVN: docutils:[10274 ] trunk/docutils

Revision: 10274
          http://sourceforge.net/p/docutils/code/10274
Author:   milde
Date:     2025-12-17 10:38:57 +0000 (Wed, 17 Dec 2025)
Log Message:
-----------
Finalise documentation of changes for 0.22.4.

Clarify wording.
Announce future change to "self-link" setting.

Modified Paths:
--------------
    trunk/docutils/HISTORY.rst
    trunk/docutils/RELEASE-NOTES.rst

Modified: trunk/docutils/HISTORY.rst
===================================================================
--- trunk/docutils/HISTORY.rst	2025-12-16 17:39:48 UTC (rev 10273)
+++ trunk/docutils/HISTORY.rst	2025-12-17 10:38:57 UTC (rev 10274)
@@ -32,6 +32,8 @@
 * docutils/writers/html/*
 
   - New value "auto" for `initial_header_level`_ configuration setting.
+    Produces a HTML document with valid "outline" for documents
+    with document title as well as documents without document title.
 
 * docutils/writers/html5_polyglot/responsive.css
 

Modified: trunk/docutils/RELEASE-NOTES.rst
===================================================================
--- trunk/docutils/RELEASE-NOTES.rst	2025-12-16 17:39:48 UTC (rev 10273)
+++ trunk/docutils/RELEASE-NOTES.rst	2025-12-17 10:38:57 UTC (rev 10274)
@@ -87,13 +87,13 @@
   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.
+  the role's name in Docutils 0.23.
 
 * Problems with the "include" directive will be reported as ERROR instead
-  of SEVERE in Docutils 1.0.
+  of SEVERE in Docutils 0.23.
 
 * The options :start-after: and :end-before: of the "include" directive
-  will support empty values (standing for an empty line).
+  will support empty values (standing for an empty line) in Docutils 0.23.
 
 * The "rst" parser will warn if a `"figure"`_ directive is missing both
   caption and legend in Docutils 1.0.
@@ -122,6 +122,9 @@
 
     __ docs/ref/rst/restructuredtext.html#explicit-hyperlink-targets
 
+  - The default of the self-link_ configuration setting will change to
+    "True" in Docutils 1.0.
+
   - 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`__
@@ -152,14 +155,14 @@
   - Change default of legacy_column_widths_ setting to False
     in Docutils 1.0.
 
-  - Remove ``use_verbatim_when_possible`` setting
-    (use literal_block_env_: verbatim) in Docutils 2.0.
-
   - The `default length unit`__ will change from "bp" (DTP point)
     to "px" (pixel unit) in Docutils 1.0.
 
     __ docs/user/latex.html#length-units
 
+  - Remove ``use_verbatim_when_possible`` setting
+    (use literal_block_env_: verbatim) in Docutils 2.0.
+
 * "manpage" writer:
 
   - Change default of the text_references_ setting to False in Docutils 1.0.
@@ -296,10 +299,17 @@
 Release 0.22.4b1 (unpublished)
 ==============================
 
+reStructuredText Specification:
+  - Clarify indentation rules: minimal indentation is *one* space.
+  - Clarify comment syntax: Comments begin with two dots and *whitespace*.
+
 HTML writers:
   - New value "auto" for the initial_header_level_ setting.
+  - Bugfixes in the provisional style-sheet "responsive.css".
 
+See HISTORY_ for details.
 
+
 Release 0.22.3 (2025-11-06)
 ===========================
 

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



_______________________________________________
Docutils-checkins mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/docutils-checkins