docutils-checkins — SVN checkin messages, auto-generated.

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

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

Revision: 10270
          http://sourceforge.net/p/docutils/code/10270
Author:   milde
Date:     2025-12-03 11:38:54 +0000 (Wed, 03 Dec 2025)
Log Message:
-----------
New value "auto" for "initial_header_level" config setting.

``initial_header_level: auto`` tells the HTML writer to use
<h2> if there is a document title, else <h1>.

This ensures a valid "outline" of the HTML document (top heading level 1,
nested headings one level below their parent).
Cf. https://html.spec.whatwg.org/multipage/sections.html#outline

Modified Paths:
--------------
    trunk/docutils/HISTORY.rst
    trunk/docutils/docs/user/config.rst
    trunk/docutils/docutils/writers/_html_base.py
    trunk/docutils/docutils/writers/html4css1/__init__.py
    trunk/docutils/docutils/writers/html5_polyglot/__init__.py
    trunk/docutils/test/test_writers/test_html5_polyglot_parts.py

Modified: trunk/docutils/HISTORY.rst
===================================================================
--- trunk/docutils/HISTORY.rst	2025-12-02 19:48:48 UTC (rev 10269)
+++ trunk/docutils/HISTORY.rst	2025-12-03 11:38:54 UTC (rev 10270)
@@ -17,6 +17,11 @@
 Release 0.22.4b1 (unpublished)
 ==============================
 
+* docutils/io.py
+
+  - Ensure `FileInput.read()` returns a `str` (decode if `source.read`
+    returns `bytes`. Fixes bug #514.
+
 * docutils/parsers/rst/directives/body.py,
   docutils/parsers/rst/directives/parts.py
 
@@ -24,6 +29,10 @@
     auxiliary elements belonging to several categories (e.g. `nodes.Root`
     and `nodes.BodyElements`) as parents of topics or sidebars.
 
+* docutils/writers/html/*
+
+  - New value "auto" for `initial_header_level`_ configuration setting.
+
 * docutils/writers/html5_polyglot/responsive.css
 
   - Increase indentation of enumerated lists to fit 2-digit numerals

Modified: trunk/docutils/docs/user/config.rst
===================================================================
--- trunk/docutils/docs/user/config.rst	2025-12-02 19:48:48 UTC (rev 10269)
+++ trunk/docutils/docs/user/config.rst	2025-12-03 11:38:54 UTC (rev 10270)
@@ -1195,13 +1195,23 @@
 
 initial_header_level
 ~~~~~~~~~~~~~~~~~~~~
-The initial level for section header elements.  This does not affect the
-document title & subtitle; see doctitle_xform_.
+The level of the first *section* heading element
+(the `document title`_ always uses <h1>).
+Supported values:
 
+:1, ..., 6: <h1>, ..., <h6>,
+:auto: <h2> if there is a `document title`_, else <h1>. [#auto-header-level]_
+
+See also `doctitle_xform`_.
+
 :Default: writer dependent
           (see `[html4css1 writer]`_, `[html5 writer]`_, `[pep_html writer]`_).
 :Option:  ``--initial-header-level``.
 
+.. [#auto-header-level] Ensures the HTML document has a valid outline__
+   in documents with/without a document title.
+   New in Docutils 0.22.3.
+__ https://html.spec.whatwg.org/multipage/sections.html#outline
 
 math_output
 ~~~~~~~~~~~
@@ -1489,14 +1499,8 @@
   "minimal.css, plain.css".
 :`xml_declaration <xml_declaration [html writers]_>`__:  False.
 
-.. [#] Documents without (visible) document title may have <h2> as highest
-   heading level, which is not recommended but valid (cf. "`Headings and
-   outlines`__" in the HTML Standard). The default will change to None
-   (<h2> if there is a document title, else <h1>) in Docutils 1.0.
+.. [#] The default will change to "auto" in Docutils 1.0.
 
-__ https://html.spec.whatwg.org/multipage/sections.html
-   #headings-and-outlines-2
-
 image_loading
 """""""""""""
 Indicate at which point images should be loaded.

Modified: trunk/docutils/docutils/writers/_html_base.py
===================================================================
--- trunk/docutils/docutils/writers/_html_base.py	2025-12-02 19:48:48 UTC (rev 10269)
+++ trunk/docutils/docutils/writers/_html_base.py	2025-12-03 11:38:54 UTC (rev 10270)
@@ -85,7 +85,7 @@
           'Does not affect document title & subtitle (see --no-doc-title).'
           '(default: writer dependent).',
           ['--initial-header-level'],
-          {'choices': '1 2 3 4 5 6'.split(), 'default': '2',
+          {'choices': '1 2 3 4 5 6 auto'.split(), 'default': '2',
            'metavar': '<level>'}),
          ('Format for footnote references: one of "superscript" or '
           '"brackets". (default: "brackets")',
@@ -295,7 +295,14 @@
         settings = self.settings
         self.language = languages.get_language(
                             settings.language_code, document.reporter)
-        self.initial_header_level = int(settings.initial_header_level)
+        if settings.initial_header_level == 'auto':
+            if len(document) and document[0].next_node(
+                    nodes.title, include_self=True, descend=False):
+                self.initial_header_level = 2
+            else:
+                self.initial_header_level = 1
+        else:
+            self.initial_header_level = int(settings.initial_header_level)
         # image_loading (only defined for HTML5 writer)
         _image_loading_default = 'link'
         # convert legacy setting embed_images:

Modified: trunk/docutils/docutils/writers/html4css1/__init__.py
===================================================================
--- trunk/docutils/docutils/writers/html4css1/__init__.py	2025-12-02 19:48:48 UTC (rev 10269)
+++ trunk/docutils/docutils/writers/html4css1/__init__.py	2025-12-03 11:38:54 UTC (rev 10270)
@@ -68,7 +68,7 @@
             'Specify the initial header level. Does not affect document '
             'title & subtitle (see --no-doc-title). (default: 1 for "<h1>")',
             ['--initial-header-level'],
-            {'choices': '1 2 3 4 5 6'.split(), 'default': '1',
+            {'choices': '1 2 3 4 5 6 auto'.split(), 'default': '1',
              'metavar': '<level>'}),
         math_output=(
             'Math output format (one of "MathML", "HTML", "MathJax", or '

Modified: trunk/docutils/docutils/writers/html5_polyglot/__init__.py
===================================================================
--- trunk/docutils/docutils/writers/html5_polyglot/__init__.py	2025-12-02 19:48:48 UTC (rev 10269)
+++ trunk/docutils/docutils/writers/html5_polyglot/__init__.py	2025-12-03 11:38:54 UTC (rev 10270)
@@ -73,7 +73,7 @@
             'Specify the initial header level. Does not affect document '
             'title & subtitle (see --no-doc-title). (default: 2 for "<h2>")',
             ['--initial-header-level'],
-            {'choices': '1 2 3 4 5 6'.split(), 'default': '2',
+            {'choices': '1 2 3 4 5 6 auto'.split(), 'default': '2',
              'metavar': '<level>'}),
         no_xml_declaration=(
             'Omit the XML declaration (default).',

Modified: trunk/docutils/test/test_writers/test_html5_polyglot_parts.py
===================================================================
--- trunk/docutils/test/test_writers/test_html5_polyglot_parts.py	2025-12-02 19:48:48 UTC (rev 10269)
+++ trunk/docutils/test/test_writers/test_html5_polyglot_parts.py	2025-12-03 11:38:54 UTC (rev 10270)
@@ -119,7 +119,8 @@
 
 totest = {}
 
-totest['standard'] = ({}, [
+totest['standard'] = ({'initial_header_level': 'auto'  # becomes standard in 1.0
+                       }, [
     ['',  # empty input string
      {}   # results in default parts
      ],
@@ -231,7 +232,8 @@
      }],
     ])
 
-totest['no_title_promotion'] = ({'doctitle_xform': False}, [
+totest['no_title_promotion'] = ({'doctitle_xform': False,
+                                 'initial_header_level': 'auto'}, [
     ["""\
 +++++
 Title
@@ -254,15 +256,15 @@
 """,
      {'fragment': """\
 <section id="title">
-<h2>Title<a class="self-link" title="link to this section" href="#title"></a></h2>
+<h1>Title<a class="self-link" title="link to this section" href="#title"></a></h1>
 <section id="not-a-subtitle">
-<h3>Not A Subtitle<a class="self-link" title="link to this section" href="#not-a-subtitle"></a></h3>
+<h2>Not A Subtitle<a class="self-link" title="link to this section" href="#not-a-subtitle"></a></h2>
 <p>Some stuff</p>
 <section id="section">
-<h4>Section<a class="self-link" title="link to this section" href="#section"></a></h4>
+<h3>Section<a class="self-link" title="link to this section" href="#section"></a></h3>
 <p>Some more stuff</p>
 <section id="another-section">
-<h5>Another Section<a class="self-link" title="link to this section" href="#another-section"></a></h5>
+<h4>Another Section<a class="self-link" title="link to this section" href="#another-section"></a></h4>
 <p>And even more stuff</p>
 </section>
 </section>

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

[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.

[Docutils-checkins] SF.net SVN: docutils:[10268] trunk/docutils/docs/ref/ doctree.rst

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

Revision: 10268
          http://sourceforge.net/p/docutils/code/10268
Author:   milde
Date:     2025-12-02 19:48:42 +0000 (Tue, 02 Dec 2025)
Log Message:
-----------
More detailled description of the restrictions on transition placement.

The formulation of the restrictions
"a transition may not begin a section or document" and
"a transition may not be at the end of a section or document"
is vague and inconsistent.

Add description of "invisible" elements that are ignored when determining
whether a transition is at the begin or end of a section or the document.

Modified Paths:
--------------
    trunk/docutils/docs/ref/doctree.rst

Modified: trunk/docutils/docs/ref/doctree.rst
===================================================================
--- trunk/docutils/docs/ref/doctree.rst	2025-12-01 22:43:32 UTC (rev 10267)
+++ trunk/docutils/docs/ref/doctree.rst	2025-12-02 19:48:42 UTC (rev 10268)
@@ -4316,24 +4316,40 @@
 :Processing: The <transition> element is typically rendered as vertical
              whitespace (more than that separating paragraphs), with or
              without a horizontal line or row of asterisks.  In novels,
-             transitions are often represented as a row of three
-             well-spaced asterisks with vertical space above and below.
-:Parents:    `\<document>`_, `\<section>`_
+             transitions are often represented as a row of three well-spaced
+             asterisks or a vignette with vertical space above and below.
+:Parents:    `\<document>`_, `\<section>`_ (cf. `%structure.model`_)
 :Children:   none (empty)
 :Attributes: only the `common attributes`_
-:Parameter Entities: `%structure.model`_ directly includes <transition>.
+:Parameter Entities: The `%structure.model`_ directly includes <transition>.
 
-A transition may not begin or end a section [#]_ or document, nor may two
-transitions be immediately adjacent.
+The document model sets additional restrictions
+on the placement of <transitions>: [#extra-rule]_
 
+* A transition may not be immediately adjacent to another transition,
+  i.e., <transition> elements must be separated by other elements.
+
+* A transition may not start the text of a document or section, i.e., a
+  <transition> is invalid as first child or preceded by only `\<title>`_,
+  `\<subtitle>`_, or invisible elements [#invisible-or-moving]_.
+
+* A transition may not occur at the end of a document or section. [#]_
+  In other words, a <transition> is invalid as last child element
+  or followed by only invisible elements [#invisible-or-moving]_.
+
 See also `Doctree Representation of Transitions`__ in
 `A Record of reStructuredText Syntax Alternatives`__.
 
-.. [#] In reStructuredText markup, a transition may appear to fall at
-   the end of a section immediately before another section.
-   A transform_ recognizes this case and moves the transition so it
-   separates the sections.
+.. [#invisible-or-moving] The elements `\<meta>`_, `\<pending>`_,
+  `\<substitution_definition>`_, and `\<target>`_ are not visible
+  in the output document. The `\<decoration>`_ element contains
+  `\<header>`_ and `\<footer>`_ which move to the respective places.
 
+.. [#] In reStructuredText markup, a transition may appear to fall
+   at the end of a section immediately before another section.
+   The `misc.Transitions` transform_ recognizes this case and
+   moves the transition so it separates the sections.
+
 __ ../dev/rst/alternatives.html#doctree-representation-of-transitions
 __ ../dev/rst/alternatives.html
 
@@ -5610,25 +5626,15 @@
      ( (`%section.elements`_;),
        (transition?, (`%section.elements`_;) )* )? )
 
-to impose the following restrictions:
+because there are additional restrictions on `\<transition>`_\ s.
+[#extra-rule]_
 
-* A `\<transition>`_ may not be the first element (i.e. it may
-  not occur at the beginning of a document or directly after
-  a title, subtitle, meta or decoration element).
-
-* Transitions must be separated by other elements (body elements,
-  sections, etc.).  In other words, a transition may not be
-  immediately adjacent to another transition.
-
-An additional restriction cannot be easily expressed in the
-language of DTDs: [#]_
-
-* A transition may not occur at the end of a document or section.
-
 The ``%structure.model`` parameter entity is directly employed in the
 content models of the `\<document>`_ and `\<section>`_ elements.
 
-.. [#] Docutils enforces it in the `misc.Transitions` transform_.
+.. [#extra-rule] The restrictions cannot be fully expressed in the
+   language of DTDs without making the definition overly complicated.
+   Docutils checks them in the `misc.Transitions` transform_.
 
 
 ``%tbl.entry.mdl``

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

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

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

Revision: 10267
          http://sourceforge.net/p/docutils/code/10267
Author:   milde
Date:     2025-12-01 22:43:32 +0000 (Mon, 01 Dec 2025)
Log Message:
-----------
docutils.io.FileInput: ensure read() returns a `str`.

Decode data read from a file-like object, if it is a `bytes` instance.

Fixes bug #514

Modified Paths:
--------------
    trunk/docutils/docs/api/publisher.rst
    trunk/docutils/docutils/core.py
    trunk/docutils/docutils/io.py

Modified: trunk/docutils/docs/api/publisher.rst
===================================================================
--- trunk/docutils/docs/api/publisher.rst	2025-11-28 13:52:09 UTC (rev 10266)
+++ trunk/docutils/docs/api/publisher.rst	2025-12-01 22:43:32 UTC (rev 10267)
@@ -525,9 +525,9 @@
   A file-like object holding the document source
   (must have `read()` and `close()` methods).
 
-  Default: None (open `source_path <source_path (file I/O)_>`__
-  or use `sys.stdin`).
+  Default: None (open `source_path`__ or use `sys.stdin`).
 
+  __
   .. _source_path (file I/O):
 
 source_path : str | pathlib.Path
@@ -534,7 +534,7 @@
   Path to the source file,
   opened if `source <source (file I/O)_>`__ is None.
 
-  Default: None (use `source <source (file I/O)_>`__).
+  Default: None (use `source <source (file I/O)_>`__ or `sys.stdin`).
 
 _`destination` : file-like
   A file-like object that will receive the output document
@@ -548,7 +548,7 @@
 destination_path : str | pathlib.Path
   Path to the destination file, opened if destination_ is None.
 
-  Default: None (use destination_).
+  Default: None (use destination_ or `sys.stdout`).
 
 
 .. _string input:
@@ -594,6 +594,7 @@
 
   Default: None.
 
+
 Component Specification
 -----------------------
 

Modified: trunk/docutils/docutils/core.py
===================================================================
--- trunk/docutils/docutils/core.py	2025-11-28 13:52:09 UTC (rev 10266)
+++ trunk/docutils/docutils/core.py	2025-12-01 22:43:32 UTC (rev 10267)
@@ -719,7 +719,7 @@
       - `io.FileInput`: Path to the input file, opened if no `source`
         supplied.
 
-      - `io.StringInput`: Optional.  Path to the file or name of the
+      - `io.StringInput`: Optional.  Path to the file or description of the
         object that produced `source`.  Only used for diagnostic output.
 
     * `destination_class` **required**: The class for dynamically created

Modified: trunk/docutils/docutils/io.py
===================================================================
--- trunk/docutils/docutils/io.py	2025-11-28 13:52:09 UTC (rev 10266)
+++ trunk/docutils/docutils/io.py	2025-12-01 22:43:32 UTC (rev 10267)
@@ -141,15 +141,13 @@
 
         Provisional: encoding detection will be removed in Docutils 1.0.
         """
-        if self.encoding and self.encoding.lower() == 'unicode':
-            assert isinstance(data, str), ('input encoding is "unicode" '
-                                           'but `data` is no `str` instance')
         if isinstance(data, str):
-            # nothing to decode
-            return data
+            return data  # nothing to decode
         if self.encoding:
             # We believe the user/application when the encoding is
             # explicitly given.
+            assert self.encoding.lower() != 'unicode', (
+                'input encoding is "unicode" but `data` is no `str` instance')
             encoding_candidates = [self.encoding]
         else:
             with warnings.catch_warnings():
@@ -419,15 +417,15 @@
     ) -> None:
         """
         :Parameters:
-            - `source`: either a file-like object (which is read directly), or
-              `None` (which implies `sys.stdin` if no `source_path` given).
-            - `source_path`: a path to a file, which is opened for reading.
-            - `encoding`: the expected text encoding of the input file.
+            - `source`: either a file-like object (with `read()` and `close()`
+              methods) or None (use source indicated by `source_path`).
+            - `source_path`: a path to a file (which is opened for reading
+              if `source` is None) or `None` (implies `sys.stdin`).
+            - `encoding`: the text encoding of the input file.
             - `error_handler`: the encoding error handler to use.
             - `autoclose`: close automatically after read (except when
-              `sys.stdin` is the source).
-            - `mode`: how the file is to be opened (see standard function
-              `open`). The default is read only ('r').
+              the source is `sys.stdin`).
+            - `mode`: how the file is to be opened. Default is read only ('r').
         """
         super().__init__(source, source_path, encoding, error_handler)
         self.autoclose = autoclose
@@ -467,7 +465,7 @@
                 # normalize newlines
                 data = '\n'.join(data.splitlines()+[''])
             else:
-                data = self.source.read()
+                data = self.decode(self.source.read())
         finally:
             if self.autoclose:
                 self.close()

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

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

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

Revision: 10266
          http://sourceforge.net/p/docutils/code/10266
Author:   milde
Date:     2025-11-28 13:52:09 +0000 (Fri, 28 Nov 2025)
Log Message:
-----------
Documentation update and fixes.

Announce upcoming changes.

The "raw" directive can be used in substitution definitions.

Hide documentation for deprecated "line-block" directive in a
details/disclosure list.

Small edits for improved clarity.

Modified Paths:
--------------
    trunk/docutils/RELEASE-NOTES.rst
    trunk/docutils/docs/ref/doctree.rst
    trunk/docutils/docs/ref/rst/directives.rst
    trunk/docutils/docs/ref/rst/restructuredtext.rst
    trunk/docutils/docs/user/config.rst
    trunk/docutils/docs/user/rst/demo.rst
    trunk/docutils/docutils/writers/html5_polyglot/__init__.py
    trunk/docutils/docutils/writers/latex2e/__init__.py

Modified: trunk/docutils/RELEASE-NOTES.rst
===================================================================
--- trunk/docutils/RELEASE-NOTES.rst	2025-11-28 13:51:57 UTC (rev 10265)
+++ trunk/docutils/RELEASE-NOTES.rst	2025-11-28 13:52:09 UTC (rev 10266)
@@ -56,9 +56,6 @@
 * The <footnote> element's first child (<label>) will become mandatory
   in Docutils 1.0.
 
-* The "rst" parser will warn if a `"figure"`_ directive is missing both
-  caption and legend in Docutils 1.0.
-
 * Inline `\<target>`_ elements and <target> elements with content will be
   deprecated in Docutils 1.0 and invalid in Docutils 2.0.
   The "rst" parser will use <inline> elements for inline targets
@@ -74,6 +71,15 @@
   The rST parser will handle a `doctest block`_ similar to a "code" directive
   with language "pycon" (Python console) and generate a <literal_block>.
 
+Parsers
+-------
+
+* 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 "rst" parser will warn if a `"figure"`_ directive is missing both
+  caption and legend in Docutils 1.0.
+
 Writers
 -------
 
@@ -93,6 +99,11 @@
 
 * "html5" writer:
 
+  - If a section title has several IDs, use the last one (from the first
+    `explicit target`__) as self-link_ in Docutils 0.23.
+
+    __ docs/ref/rst/restructuredtext.html#explicit-hyperlink-targets
+
   - Move attribution behind the blockquote to comply with the
     `"HTML living standard"`__ [#]_ and adapt CSS stylesheets
     in Docutils 1.0.
@@ -107,8 +118,9 @@
 
 * "latex2e" writer:
 
-  - Only write ``\label`` commands for IDs that are referenced in the
-    current document in Docutils 0.23.
+  - Only write ``\label`` commands for explicit IDs and IDs that are
+    referenced in the current document (i.e. not for un-referenced
+    section titles) in Docutils 0.23.
 
   - Change default of use_latex_citations_ setting to True
     in Docutils 1.0.
@@ -1560,6 +1572,7 @@
 .. _output_path: docs/user/config.html#output-path
 .. _reference_label: docs/user/config.html#reference-label
 .. _root_prefix: docs/user/config.html#root-prefix
+.. _self-link: docs/user/config.html#section-self-link
 .. _SmartQuotes: docs/user/config.html#smart-quotes
 .. _sources: docs/user/config.html#sources
 .. _use_latex_citations: docs/user/config.html#use-latex-citations

Modified: trunk/docutils/docs/ref/doctree.rst
===================================================================
--- trunk/docutils/docs/ref/doctree.rst	2025-11-28 13:51:57 UTC (rev 10265)
+++ trunk/docutils/docs/ref/doctree.rst	2025-11-28 13:52:09 UTC (rev 10266)
@@ -3854,8 +3854,9 @@
 :Children:   one or more `body elements`_
 :Attributes: backrefs_, level_, line_, type_, and the `common attributes`_.
 
-In Docutils, the generation of system messages can be configured with the
-`"report_level"`_ setting.
+In Docutils, system messages with a level lower than the
+`"report_level"`_ setting are removed by the `universal.FilterMessages`
+transform_.
 
 Examples
 --------
@@ -4249,8 +4250,9 @@
 
 :Category:   `Structural Elements`_
 
-:Analogues:  <topic> is analogous to the DocBook_ <simplesect> element
-             and the HTML_ <aside> element.
+:Analogues:  <topic> is analogous to the HTML_ <aside> element.
+             The DocBook_ <simplesect> element is similar, but you cannot
+             place `body elements`_ after a <simplesect>.
 
 :Processing: A <topic> element should be set off from the rest of the
              document somehow, such as with indentation or a border.
@@ -5794,7 +5796,7 @@
   .. _namespace:
 
   Almost all elements in a document share a common *namespace*
-  for reference names, comparison ignores case.
+  for reference names and match them ignoring case.
   Only `\<substitution_definition>`_ and `\<substitution_reference>`_
   elements use a distinct namespace with `case-sensitive but forgiving`_
   matching of reference names.

Modified: trunk/docutils/docs/ref/rst/directives.rst
===================================================================
--- trunk/docutils/docs/ref/rst/directives.rst	2025-11-28 13:51:57 UTC (rev 10265)
+++ trunk/docutils/docs/ref/rst/directives.rst	2025-11-28 13:52:09 UTC (rev 10266)
@@ -453,8 +453,8 @@
 A topic is like a block quote with a title, or a self-contained
 section with no subsections.  Use the "topic" directive to indicate a
 self-contained idea that is separate from the flow of the document.
-Topics may occur anywhere a section or transition may occur and
-in sidebars.  Body elements and topics may not contain nested topics.
+Topics may be nested in the document, a section, or a
+sidebar_.  Body elements and topics may not contain topics.
 
 The directive's sole argument is interpreted as the topic title; the
 next line must be blank.  All subsequent lines make up the topic body,
@@ -511,13 +511,6 @@
 Line Block
 ==========
 
-.. admonition:: Deprecated
-
-   The "line-block" directive is deprecated.  Use the `line block
-   syntax`_ instead.
-
-   .. _line block syntax: restructuredtext.html#line-blocks
-
 .. class:: field-indent-13em
 
 :Directive Type: "line-block"
@@ -526,28 +519,31 @@
 :Directive Options: `class <class option_>`_, name_
 :Directive Content: Becomes the body of the line block.
 
-The "line-block" directive constructs an element where line breaks and
-initial indentation is significant and inline markup is supported.  It
-is equivalent to a `parsed literal block`_ with different rendering:
-typically in an ordinary serif typeface instead of a
-typewriter/monospaced face, and not automatically indented.  (Have the
-line-block directive begin a block quote to get an indented line
-block.)  Line blocks are useful for address blocks and verse (poetry,
-song lyrics), where the structure of lines is significant.  For
-example, here's a classic::
+.. class:: details
 
-    "To Ma Own Beloved Lassie: A Poem on her 17th Birthday", by
-    Ewan McTeagle (for Lassie O'Shea):
+**Deprecated.**  Use the `line block syntax`_ instead.
+  The "line-block" directive constructs an element where line breaks and
+  initial indentation is significant and inline markup is supported.  It
+  is comparable to a `parsed literal block`_ with different rendering:
+  typically in an ordinary serif typeface instead of a
+  typewriter/monospaced face, and not automatically indented.  (Have the
+  line-block directive begin a block quote to get an indented line
+  block.)  Line blocks are useful for address blocks and verse (poetry,
+  song lyrics), where the structure of lines is significant.  For
+  example, here's a classic::
 
-        .. line-block::
+      "To Ma Own Beloved Lassie: A Poem on her 17th Birthday", by
+      Ewan McTeagle (for Lassie O'Shea):
 
-            Lend us a couple of bob till Thursday.
-            I'm absolutely skint.
-            But I'm expecting a postal order and I can pay you back
-                as soon as it comes.
-            Love, Ewan.
+          .. line-block::
 
+              Lend us a couple of bob till Thursday.
+              I'm absolutely skint.
+              But I'm expecting a postal order and I can pay you back
+                  as soon as it comes.
+              Love, Ewan.
 
+
 .. _parsed-literal:
 
 Parsed Literal Block
@@ -1171,9 +1167,9 @@
 :Directive Content: none
 :Configuration Settings: toc_backlinks_, use_latex_toc_, generate_oowriter_toc_
 
-The "contents" directive generates a table of contents (TOC) in
+The "contents" directive generates a table of contents (ToC) in
 a `\<topic>`_ element.  Topics, and therefore tables of contents,
-may occur anywhere a section or transition may occur and in sidebars.
+may be nested in the document, a section, or a sidebar_.
 Body elements and topics may not contain tables of contents.
 
 Here's the directive in its simplest form::
@@ -1284,6 +1280,8 @@
 Document Header & Footer
 ========================
 
+.. class:: field-indent-13em
+
 :Directive Types: "header" and "footer"
 :Doctree Elements: `\<decoration>`_, `\<header>`_, `\<footer>`_
 :Directive Arguments: none
@@ -1411,18 +1409,13 @@
  Directives for Substitution Definitions
 -----------------------------------------
 
-The directives introduced in this section may be used in
-`substitution definitions`_.  They may not be used directly,
-in standalone context (except for the image_ directive).
+This section lists directives that may be used in `substitution definitions`_.
 
-.. _substitution definitions:
-.. _substitution definition: restructuredtext.html#substitution-definitions
 
-
 Inline Images
 =============
 
-The `image`_ directive can be used both, stand-alone (to define
+The "`image`_" directive can be used both, stand-alone (to define
 block-level images) and in substitution definitions to define
 inline images. [#no-inline-name]_
 
@@ -1430,6 +1423,15 @@
                      a substitution definition. [#substitution-limits]_
 
 
+Inline Raw
+==========
+
+The "raw_" directive can be used stand-alone and in substitution definitions.
+
+"Raw data pass-through" in inline context is also possible with
+a `custom role`_ derived from the `"raw" role`_.
+
+
 .. _replace:
 
 Replacement Text
@@ -1464,10 +1466,11 @@
     .. |Python| replace:: Python, *the* best language around
     .. _Python: https://www.python.org/
 
-.. [#substitution-limits] As a substitution may be referenced more than
-   one time, a substitution definition may not contain references to
-   `anonymous hyperlinks`_, `auto-numbered`_ or `auto-symbol`_ footnotes
-   and no `hyperlink targets`__ (names and identifiers must be unique).
+.. [#substitution-limits]
+   A substitution definition may not contain references to `anonymous
+   hyperlinks`_, `auto-numbered`_ or `auto-symbol`_ footnotes and no
+   `hyperlink targets`__ because a substitution may be referenced more
+   than once but names and identifiers must be unique.
 
    __ restructuredtext.html#inline-internal-targets
 
@@ -1768,6 +1771,8 @@
 
 Inline equivalents of the "raw" directive can be defined via
 `custom interpreted text roles`_ derived from the `"raw" role`_.
+The "raw" directive can also be used directly in a `substitution
+definition`_.
 
 .. _raw options:
 
@@ -1788,8 +1793,8 @@
 .. _class directive:
 .. _rst-class:
 
-Class
-=====
+Setting Class Attributes
+========================
 
 .. class:: field-indent-13em
 
@@ -1949,6 +1954,7 @@
 
 
 .. _role:
+.. _custom role:
 
 Custom Interpreted Text Roles
 =============================
@@ -2342,10 +2348,13 @@
 .. _hyperlink references: restructuredtext.html#hyperlink-references
 .. _hyperlink targets:
 .. _hyperlink target: restructuredtext.html#hyperlink-targets
+.. _line block syntax: restructuredtext.html#line-blocks
 .. _reference name:
 .. _reference names: restructuredtext.html#reference-names
 .. _section title style hierarchy: restructuredtext.html#title-styles
 .. _simple table: restructuredtext.html#simple-tables
+.. _substitution definitions:
+.. _substitution definition: restructuredtext.html#substitution-definitions
 .. _supported length units: restructuredtext.html#length-units
 
 .. _reStructuredText Interpreted Text Roles:

Modified: trunk/docutils/docs/ref/rst/restructuredtext.rst
===================================================================
--- trunk/docutils/docs/ref/rst/restructuredtext.rst	2025-11-28 13:51:57 UTC (rev 10265)
+++ trunk/docutils/docs/ref/rst/restructuredtext.rst	2025-11-28 13:52:09 UTC (rev 10266)
@@ -88,7 +88,7 @@
 
          1. This is an enumerated list.
 
-         2. Enumerators may be arabic numbers, letters, or roman
+         2. Enumerators may be arabic numerals, letters, or roman
             numerals.
 
   3. `Definition lists`_::
@@ -204,7 +204,7 @@
 
   - Comments_::
 
-        .. Comments begin with two dots and a space.  Anything may
+        .. Comments begin with two dots and whitespace.  Anything may
            follow, except for the syntax of footnotes/citations,
            hyperlink targets, directives, or substitution definitions.
 
@@ -359,7 +359,7 @@
   itself. (A literal backslash can be specified by two backslashes in a
   row -- the first backslash escapes the second. [#caveat]_)
 
-* Escaped whitespace characters are removed from the output document
+* _`Escaped whitespace` characters are removed from the output document
   together with the escaping backslash. This allows for `character-level
   inline markup`_.
 
@@ -743,7 +743,7 @@
 Enumerated lists (a.k.a. "ordered" lists) are similar to bullet lists,
 but use enumerators instead of bullets.  An enumerator consists of an
 enumeration sequence member and formatting, followed by whitespace.
-The following enumeration sequences are recognized:
+The following *enumeration sequences* are recognized:
 
 - arabic numerals: 1, 2, 3, ... (no upper limit).
 - uppercase alphabet characters: A, B, C, ..., Z.
@@ -753,10 +753,10 @@
 
 In addition, the auto-enumerator, ``#``, may be used to automatically
 enumerate a list.  Auto-enumerated lists may begin with explicit
-enumeration, which sets the sequence.  Fully auto-enumerated lists use
-arabic numerals and begin with 1.
+enumeration, which sets the sequence and start value.
+Fully auto-enumerated lists use arabic numerals and begin with 1.
 
-The following formatting types are recognized:
+The following *formatting types* are recognized:
 
 - suffixed with a period: ``1.``, ``A.``, ``a.``, ``I.``, ``i.``.
 - surrounded by parentheses: ``(1)``, ``(A)``, ``(a)``, ``(I)``, ``(i)``.
@@ -1377,7 +1377,7 @@
 
         -- Sherlock Holmes
 
-A block quote may end with an attribution: a text block beginning with
+A block quote may end with an _`attribution`: a paragraph beginning with
 ``--``, ``---``, or a true em-dash, flush left within the block quote.  If
 the attribution consists of multiple lines, the left edges of the
 second and subsequent lines must align.
@@ -2299,9 +2299,14 @@
 
 The following *inline-compatible directives* are implemented in Docutils:
 
+:`"date"`_: inserts the current local date.
+
 :`"image"`_: can be used for block-level images as well as in a
              substitution definition for `inline images`_.
 
+:`"raw"`_: can be used in block-level context as well as in a
+           substitution definition.
+
 :`"replace"`_: allows simple macro substitution.
   It also provides a workaround__ for the still missing support of
   nested inline markup.
@@ -2310,8 +2315,6 @@
 
 :`"unicode"`_: converts Unicode character codes to characters.
 
-:`"date"`_: inserts the current local date.
-
 Applications may find other use cases for the substitution mechanism.
 The following are ideas that have not been implemented in Docutils.
 

Modified: trunk/docutils/docs/user/config.rst
===================================================================
--- trunk/docutils/docs/user/config.rst	2025-11-28 13:51:57 UTC (rev 10265)
+++ trunk/docutils/docs/user/config.rst	2025-11-28 13:52:09 UTC (rev 10266)
@@ -1521,8 +1521,8 @@
 
 section_self_link
 """""""""""""""""
-Append an empty anchor element with a ``href`` to the section to
-section headings. See ``responsive.css`` for an example how this can be
+Extend section headings with an empty <a> element with a ``href`` to
+the section.  See ``responsive.css`` for an example how this can be
 styled to show a symbol allowing users to copy the section's URL.
 
 :Default: False.

Modified: trunk/docutils/docs/user/rst/demo.rst
===================================================================
--- trunk/docutils/docs/user/rst/demo.rst	2025-11-28 13:51:57 UTC (rev 10265)
+++ trunk/docutils/docs/user/rst/demo.rst	2025-11-28 13:52:09 UTC (rev 10266)
@@ -546,7 +546,7 @@
 
 Here's one:
 
-.. Comments begin with two dots and a space. Anything may
+.. Comments begin with two dots and whitespace. Anything may
    follow, except for the syntax of footnotes, hyperlink
    targets, directives, or substitution definitions.
 

Modified: trunk/docutils/docutils/writers/html5_polyglot/__init__.py
===================================================================
--- trunk/docutils/docutils/writers/html5_polyglot/__init__.py	2025-11-28 13:51:57 UTC (rev 10265)
+++ trunk/docutils/docutils/writers/html5_polyglot/__init__.py	2025-11-28 13:52:09 UTC (rev 10266)
@@ -388,6 +388,8 @@
     def section_title_tags(self, node):
         start_tag, close_tag = super().section_title_tags(node)
         ids = node.parent['ids']
+        # TODO: use ``ids[-1]``
+        # (IDs from explicit targets are appended to the implicit ID)
         if (ids and getattr(self.settings, 'section_self_link', None)
             and not isinstance(node.parent, nodes.document)):
             self_link = ('<a class="self-link" title="link to this section"'

Modified: trunk/docutils/docutils/writers/latex2e/__init__.py
===================================================================
--- trunk/docutils/docutils/writers/latex2e/__init__.py	2025-11-28 13:51:57 UTC (rev 10265)
+++ trunk/docutils/docutils/writers/latex2e/__init__.py	2025-11-28 13:52:09 UTC (rev 10266)
@@ -2600,23 +2600,21 @@
         self.depart_inline(node)
         self.out.append('}')
 
-    # Literal blocks are used for '::'-prefixed literal-indented
-    # blocks of text, where the inline markup is not recognized,
-    # but are also the product of the "parsed-literal" directive,
-    # where the markup is respected.
+    # <literal_block> elements are used
+    # for literal blocks (where content is not parsed),
+    # for the "code" directive (where content may be parsed by Pygments), and
+    # for the "parsed-literal" directive (where rST inline markup is parsed).
     #
-    # In both cases, we want to use a typewriter/monospaced typeface.
-    # For "real" literal-blocks, we can use \verbatim, while for all
-    # the others we must use \ttfamily and \raggedright.
+    # In all cases, we want to use a monospaced typeface.
+    # If the <literal_block> contains only text, we can use a "verbatim-like"
+    # environment, for mixed content we must use \ttfamily and \raggedright.
     #
-    # We can distinguish between the two kinds by the number of
-    # siblings that compose this node: if it is composed by a
-    # single element, it's either
-    # * a real one,
-    # * a parsed-literal that does not contain any markup, or
-    # * a parsed-literal containing just one markup construct.
+    # We can distinguish between the use cases looking at the element's
+    # children: if there is a single <Text> child, it is either
+    # * a "real" literal block or
+    # * a parsed-literal that does not contain any markup.
     def is_plaintext(self, node):
-        """Check whether a node can be typeset verbatim"""
+        """Check whether `node` contains only text"""
         return (len(node) == 1) and isinstance(node[0], nodes.Text)
 
     def visit_literal_block(self, node) -> None:

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

[Docutils-checkins] SF.net SVN: docutils:[10265] trunk/docutils/docutils/ transforms/misc.py

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

Revision: 10265
          http://sourceforge.net/p/docutils/code/10265
Author:   milde
Date:     2025-11-28 13:51:57 +0000 (Fri, 28 Nov 2025)
Log Message:
-----------
Simplify `ClassAttribute` transform.

Use `node.findall()` instead of a re-implementation to find the
right element to attach the class attribute to.
No change to functionality.

Modified Paths:
--------------
    trunk/docutils/docutils/transforms/misc.py

Modified: trunk/docutils/docutils/transforms/misc.py
===================================================================
--- trunk/docutils/docutils/transforms/misc.py	2025-11-28 13:51:41 UTC (rev 10264)
+++ trunk/docutils/docutils/transforms/misc.py	2025-11-28 13:51:57 UTC (rev 10265)
@@ -45,22 +45,14 @@
 
     def apply(self) -> None:
         pending = self.startnode
-        parent = pending.parent
-        child = pending
-        while parent:
-            # Check for appropriate following siblings:
-            for index in range(parent.index(child) + 1, len(parent)):
-                element = parent[index]
-                if (isinstance(element, nodes.Invisible)
-                    or isinstance(element, nodes.system_message)):
-                    continue
-                element['classes'] += pending.details['class']
-                pending.parent.remove(pending)
-                return
-            else:
-                # At end of section or container; apply to sibling
-                child = parent
-                parent = parent.parent
+        for element in pending.findall(include_self=False, descend=False,
+                                       siblings=True, ascend=True):
+            if isinstance(element, (nodes.Invisible, nodes.system_message)):
+                continue
+            element['classes'] += pending.details['class']
+            pending.parent.remove(pending)
+            return
+
         error = self.document.reporter.error(
             'No suitable element following "%s" directive'
             % pending.details['directive'],

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

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

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

Revision: 10264
          http://sourceforge.net/p/docutils/code/10264
Author:   milde
Date:     2025-11-28 13:51:41 +0000 (Fri, 28 Nov 2025)
Log Message:
-----------
Fixes for the "responsive" CSS style sheet.

Modified Paths:
--------------
    trunk/docutils/HISTORY.rst
    trunk/docutils/docutils/writers/html5_polyglot/responsive.css

Modified: trunk/docutils/HISTORY.rst
===================================================================
--- trunk/docutils/HISTORY.rst	2025-11-28 13:51:32 UTC (rev 10263)
+++ trunk/docutils/HISTORY.rst	2025-11-28 13:51:41 UTC (rev 10264)
@@ -24,7 +24,15 @@
     auxiliary elements belonging to several categories (e.g. `nodes.Root`
     and `nodes.BodyElements`) as parents of topics or sidebars.
 
+* docutils/writers/html5_polyglot/responsive.css
 
+  - Increase indentation of enumerated lists to fit 2-digit numerals
+    and of bullet lists to keep them looking similar.
+  - Use "top" instead of "baseline" for the vertical alignment in table
+    rows. ("Baseline" fails if one cell contains certain body elements,
+    e.g. a figure or a table with caption.)
+
+
 Release 0.22.3 (2025-11-06)
 ===========================
 

Modified: trunk/docutils/docutils/writers/html5_polyglot/responsive.css
===================================================================
--- trunk/docutils/docutils/writers/html5_polyglot/responsive.css	2025-11-28 13:51:32 UTC (rev 10263)
+++ trunk/docutils/docutils/writers/html5_polyglot/responsive.css	2025-11-28 13:51:41 UTC (rev 10264)
@@ -134,13 +134,12 @@
 
 /* Lists */
 
+ul, ol {
+  padding-left: 2em; /* allow for 2-digit numbers */
+}
 dl.field-list.narrow {
   --field-indent: 2.4em;
 }
-
-ul, ol {
-  padding-left: 1.1em; /* indent by bullet width (Firefox, DejaVu fonts) */
-}
 dl.field-list > dd,
 dl.docinfo > dd {
   margin-left: var(--field-indent); /* adapted in media queries or HTML */
@@ -204,7 +203,7 @@
 
 table tr {
   text-align: left;
-  vertical-align: baseline;
+  vertical-align: top;
 }
 td *:first-child { margin-top: 0; }
 td *:last-child { margin-bottom: 0; }

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

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

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

Revision: 10263
          http://sourceforge.net/p/docutils/code/10263
Author:   milde
Date:     2025-11-28 13:51:32 +0000 (Fri, 28 Nov 2025)
Log Message:
-----------
Future-proof the test for valid parents of topics or sidebars.

Test a "whitelist" of categories before the "blacklist"
to allow auxiliary elements belonging to several categories
(e.g. `nodes.Root` and `nodes.BodyElements`) as parents
of topics or sidebars.
This still gives uncategorized nodes the "benefit of daubt"
but supports properly categorized nodes as well.

Modified Paths:
--------------
    trunk/docutils/HISTORY.rst
    trunk/docutils/docutils/parsers/rst/directives/body.py
    trunk/docutils/docutils/parsers/rst/directives/parts.py

Modified: trunk/docutils/HISTORY.rst
===================================================================
--- trunk/docutils/HISTORY.rst	2025-11-06 03:39:16 UTC (rev 10262)
+++ trunk/docutils/HISTORY.rst	2025-11-28 13:51:32 UTC (rev 10263)
@@ -17,9 +17,14 @@
 Release 0.22.4b1 (unpublished)
 ==============================
 
-.
+* docutils/parsers/rst/directives/body.py,
+  docutils/parsers/rst/directives/parts.py
 
+  - Test a "whitelist" of categories before the "blacklist" to allow
+    auxiliary elements belonging to several categories (e.g. `nodes.Root`
+    and `nodes.BodyElements`) as parents of topics or sidebars.
 
+
 Release 0.22.3 (2025-11-06)
 ===========================
 

Modified: trunk/docutils/docutils/parsers/rst/directives/body.py
===================================================================
--- trunk/docutils/docutils/parsers/rst/directives/body.py	2025-11-06 03:39:16 UTC (rev 10262)
+++ trunk/docutils/docutils/parsers/rst/directives/body.py	2025-11-28 13:51:32 UTC (rev 10263)
@@ -40,7 +40,9 @@
     """
 
     def run(self):
-        if isinstance(self.state_machine.node, self.invalid_parents):
+        if (not isinstance(self.state_machine.node,
+                           (nodes.Root, nodes.section, nodes.sidebar))
+            and isinstance(self.state_machine.node, self.invalid_parents)):
             raise self.error('The "%s" directive may not be used within '
                              'topics or body elements.' % self.name)
         self.assert_has_content()

Modified: trunk/docutils/docutils/parsers/rst/directives/parts.py
===================================================================
--- trunk/docutils/docutils/parsers/rst/directives/parts.py	2025-11-06 03:39:16 UTC (rev 10262)
+++ trunk/docutils/docutils/parsers/rst/directives/parts.py	2025-11-28 13:51:32 UTC (rev 10263)
@@ -44,8 +44,10 @@
                    'class': directives.class_option}
 
     def run(self):
-        if isinstance(self.state_machine.node,
-                      BasePseudoSection.invalid_parents):
+        if (not isinstance(self.state_machine.node,
+                           (nodes.Root, nodes.section, nodes.sidebar))
+            and isinstance(self.state_machine.node,
+                           BasePseudoSection.invalid_parents)):
             raise self.error('The "%s" directive may not be used within '
                              'topics or body elements.' % self.name)
         document = self.state_machine.document

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

[Docutils-checkins] SF.net SVN: docutils:[10262] trunk/sandbox/infrastruc ture/releasing-log.rst

[<gr...@us...>]

Revision: 10262
          http://sourceforge.net/p/docutils/code/10262
Author:   grubert
Date:     2025-11-06 03:39:16 +0000 (Thu, 06 Nov 2025)
Log Message:
-----------
add email

Modified Paths:
--------------
    trunk/sandbox/infrastructure/releasing-log.rst

Modified: trunk/sandbox/infrastructure/releasing-log.rst
===================================================================
--- trunk/sandbox/infrastructure/releasing-log.rst	2025-11-06 03:38:01 UTC (rev 10261)
+++ trunk/sandbox/infrastructure/releasing-log.rst	2025-11-06 03:39:16 UTC (rev 10262)
@@ -99,7 +99,9 @@
 * commit
 * now tox -epy311 passes
 * run: sandbox/infrastructure/docutils-update.local
+* send notification emails
 
+
 Release 0.22.2 (2025-09-20)
 ===========================
 

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

[Docutils-checkins] SF.net SVN: docutils:[10261] trunk/sandbox/infrastruc ture/releasing-log.rst

[<gr...@us...>]

Revision: 10261
          http://sourceforge.net/p/docutils/code/10261
Author:   grubert
Date:     2025-11-06 03:38:01 +0000 (Thu, 06 Nov 2025)
Log Message:
-----------
release 0.22.3

Modified Paths:
--------------
    trunk/sandbox/infrastructure/releasing-log.rst

Modified: trunk/sandbox/infrastructure/releasing-log.rst
===================================================================
--- trunk/sandbox/infrastructure/releasing-log.rst	2025-11-06 03:36:16 UTC (rev 10260)
+++ trunk/sandbox/infrastructure/releasing-log.rst	2025-11-06 03:38:01 UTC (rev 10261)
@@ -10,6 +10,96 @@
 Notes on what happend while releasing.
 
 
+Release 0.22.3 (2025-11-06)
+===========================
+
+Quick tiny release for two important bugfixes.
+
+1. The longstanding issue with combining characters in grid tables is finally
+   solved.
+
+2. A fix for a problem for Sphinx users with Docutils 0.22.2 is solved as well.
+
+* checkout current code
+* run: tox -epy313
+* set_version 0.22.3
+* run: tox -epy311
+* fix the version_info release=True, releaselevel=final, serial=0
+* run: tox -epy39
+* Check README, HISTORY and RELEASE-NOTES titles.
+* check: svn di
+* svn commit 
+* check for swap files: ``find . -name \*.sw\*``
+* build wheel and tgz
+* test tgz and wheel locally
+* update code in working directory
+* tag #.# (Note: only directory docutils is copied)::
+
+    svn copy svn+ssh://grubert@svn.code.sf.net/p/docutils/code/trunk/docutils \
+             svn+ssh://grubert@svn.code.sf.net/p/docutils/code/tags/docutils-0.22.3 \
+             -m "tagging release 0.22.3"
+
+* check on sourceforge: https://sourceforge.net/p/docutils/code/HEAD/tree/tags/
+* update code in build directory
+* build wheel and tgz
+* test tgz and wheel locally
+* upload to pypi
+* remove wheels from cache::
+
+    find .cache/pip/wheels -name docutils\*whl
+
+* test src.tgz from pypi, ignore missing HISTORY::
+
+    pip install --pre --no-binary docutils docutils
+
+* remove wheels from cache
+* test wheel from pypi, ignore missing HISTORY.rst
+* update code in working directory
+* run tox : pass 39, 310, 311, 313, 314
+* upload source and generated html to sf-htdocs/#.# ::
+
+    mkdir tmp1
+    cd tmp1
+    tar xzvf ../dist/docutils-0.22.3.tar.gz
+    cd docutils-0.22.3/
+    python3 tools/buildhtml.py .
+    find . -name \*.pyc -exec rm -v {} \;
+    find . -name __pycache__ -exec rmdir -v {} \;
+    rsync -e ssh -r -t ./ web.sourceforge.net:/home/project-web/docutils/htdocs/0.22.3
+
+* Check https://docutils.sourceforge.io/0.22.3/
+* Check web/index.rst for necessary corrections.
+* Run sandbox/infrastructure/docutils-update.local to update web-content.
+
+* Release to sourceforge.
+
+  - Upload docutils-0.22.3.tar.gz and release notes to sourceforge.
+  - Upload RELEASE_NOTES.rst as README.rst.
+  - Select docutils-0.22.3.tar.gz as default for all OS.
+
+* update working directory
+* set_version 0.22.4b1.dev
+* check docutils/__init__ ok
+* tox -epy39 310 312 313 pass
+* tox-epy311 fails : somewhere is 0.22.3
+
+  - tox is running in py311
+  - py311 has docutils 0.22.2 installed
+
+  in working directory ``python3.11 test/test__init__.py``
+  fails with ::
+
+    '0.22.3' != '0.22.4b1.dev'
+    __version__ != __version_info__
+
+* docutils/HISTORY.rst: add title "Release 0.22.4b1.dev (unpublished)"
+* docutils/RELEASE-NOTES.rst: add title "Release 0.22.4b1.dev (unpublished)"
+* Check README, HISTORY and RELEASE-NOTES titles.
+* svn di
+* commit
+* now tox -epy311 passes
+* run: sandbox/infrastructure/docutils-update.local
+
 Release 0.22.2 (2025-09-20)
 ===========================
 
@@ -35,7 +125,7 @@
 
     pip install --pre --no-binary docutils docutils
 
-* check for swap files in testenvironmen: ``find . -name \*.sw\*``
+* check for swap files in testenvironment: ``find . -name \*.sw\*``
 * test wheel from pypi, ignore missing HISTORY.rst
 * update code in working directory
 * run tox : pass 39, 310, 311, 313, 314

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

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

[<gr...@us...>]

Revision: 10260
          http://sourceforge.net/p/docutils/code/10260
Author:   grubert
Date:     2025-11-06 03:36:16 +0000 (Thu, 06 Nov 2025)
Log Message:
-----------
version 0.22.4b1

Modified Paths:
--------------
    trunk/docutils/HISTORY.rst
    trunk/docutils/README.rst
    trunk/docutils/RELEASE-NOTES.rst
    trunk/docutils/docutils/__init__.py
    trunk/docutils/test/functional/expected/buggy_mathml.html
    trunk/docutils/test/functional/expected/buggy_mathml_blahtexml.html
    trunk/docutils/test/functional/expected/buggy_mathml_pandoc.html
    trunk/docutils/test/functional/expected/buggy_mathml_ttm.html
    trunk/docutils/test/functional/expected/compact_lists.html
    trunk/docutils/test/functional/expected/dangerous.html
    trunk/docutils/test/functional/expected/field_name_limit.html
    trunk/docutils/test/functional/expected/footnotes_html5.html
    trunk/docutils/test/functional/expected/length_units_html5.html
    trunk/docutils/test/functional/expected/math_experiments_mathml.html
    trunk/docutils/test/functional/expected/math_experiments_mathml_blahtexml.html
    trunk/docutils/test/functional/expected/math_experiments_mathml_pandoc.html
    trunk/docutils/test/functional/expected/math_experiments_mathml_ttm.html
    trunk/docutils/test/functional/expected/math_output_html.html
    trunk/docutils/test/functional/expected/math_output_latex.html
    trunk/docutils/test/functional/expected/math_output_mathjax.html
    trunk/docutils/test/functional/expected/math_output_mathml.html
    trunk/docutils/test/functional/expected/mathematics_mathml.html
    trunk/docutils/test/functional/expected/mathematics_mathml_blahtexml.html
    trunk/docutils/test/functional/expected/mathematics_mathml_pandoc.html
    trunk/docutils/test/functional/expected/mathematics_mathml_ttm.html
    trunk/docutils/test/functional/expected/misc_rst_html4css1.html
    trunk/docutils/test/functional/expected/misc_rst_html5.html
    trunk/docutils/test/functional/expected/pep_html.html
    trunk/docutils/test/functional/expected/rst_html5_tuftig.html
    trunk/docutils/test/functional/expected/standalone_rst_docutils_xml.xml
    trunk/docutils/test/functional/expected/standalone_rst_html4css1.html
    trunk/docutils/test/functional/expected/standalone_rst_html5.html
    trunk/docutils/test/functional/expected/standalone_rst_manpage.man
    trunk/docutils/test/functional/expected/standalone_rst_s5_html_1.html
    trunk/docutils/test/functional/expected/standalone_rst_s5_html_2.html
    trunk/docutils/test/test_writers/test_manpage.py

Modified: trunk/docutils/HISTORY.rst
===================================================================
--- trunk/docutils/HISTORY.rst	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/HISTORY.rst	2025-11-06 03:36:16 UTC (rev 10260)
@@ -14,6 +14,12 @@
 .. contents::
 
 
+Release 0.22.4b1 (unpublished)
+==============================
+
+.
+
+
 Release 0.22.3 (2025-11-06)
 ===========================
 

Modified: trunk/docutils/README.rst
===================================================================
--- trunk/docutils/README.rst	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/README.rst	2025-11-06 03:36:16 UTC (rev 10260)
@@ -1,6 +1,6 @@
-=========================
- README: Docutils 0.22.3
-=========================
+===============================
+ README: Docutils 0.22.4b1.dev
+===============================
 
 :Author: David Goodger
 :Contact: go...@py...

Modified: trunk/docutils/RELEASE-NOTES.rst
===================================================================
--- trunk/docutils/RELEASE-NOTES.rst	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/RELEASE-NOTES.rst	2025-11-06 03:36:16 UTC (rev 10260)
@@ -263,6 +263,12 @@
    __ https://packages.debian.org/source/trixie/python-docutils
 
 
+Release 0.22.4b1 (unpublished)
+==============================
+
+.
+
+
 Release 0.22.3 (2025-11-06)
 ===========================
 

Modified: trunk/docutils/docutils/__init__.py
===================================================================
--- trunk/docutils/docutils/__init__.py	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/docutils/__init__.py	2025-11-06 03:36:16 UTC (rev 10260)
@@ -85,7 +85,7 @@
 
 __docformat__ = 'reStructuredText'
 
-__version__ = '0.22.3'
+__version__ = '0.22.4b1.dev'
 """Docutils version identifier (complies with PEP 440)::
 
     major.minor[.micro][releaselevel[serial]][.dev]
@@ -159,10 +159,10 @@
 __version_info__ = VersionInfo(
     major=0,
     minor=22,
-    micro=3,
-    releaselevel='final',  # one of 'alpha', 'beta', 'candidate', 'final'
-    serial=0,  # pre-release number (0 for final releases and snapshots)
-    release=True  # True for official releases and pre-releases
+    micro=4,
+    releaselevel='beta',  # one of 'alpha', 'beta', 'candidate', 'final'
+    serial=1,  # pre-release number (0 for final releases and snapshots)
+    release=False  # True for official releases and pre-releases
     )
 """Comprehensive version information tuple.
 

Modified: trunk/docutils/test/functional/expected/buggy_mathml.html
===================================================================
--- trunk/docutils/test/functional/expected/buggy_mathml.html	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/test/functional/expected/buggy_mathml.html	2025-11-06 03:36:16 UTC (rev 10260)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.4b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>buggy-maths</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/buggy_mathml_blahtexml.html
===================================================================
--- trunk/docutils/test/functional/expected/buggy_mathml_blahtexml.html	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/test/functional/expected/buggy_mathml_blahtexml.html	2025-11-06 03:36:16 UTC (rev 10260)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.4b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>buggy-maths</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/buggy_mathml_pandoc.html
===================================================================
--- trunk/docutils/test/functional/expected/buggy_mathml_pandoc.html	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/test/functional/expected/buggy_mathml_pandoc.html	2025-11-06 03:36:16 UTC (rev 10260)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.4b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>buggy-maths</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/buggy_mathml_ttm.html
===================================================================
--- trunk/docutils/test/functional/expected/buggy_mathml_ttm.html	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/test/functional/expected/buggy_mathml_ttm.html	2025-11-06 03:36:16 UTC (rev 10260)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.4b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>buggy-maths</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/compact_lists.html
===================================================================
--- trunk/docutils/test/functional/expected/compact_lists.html	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/test/functional/expected/compact_lists.html	2025-11-06 03:36:16 UTC (rev 10260)
@@ -3,7 +3,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.4b1.dev: https://docutils.sourceforge.io/" />
 <title>compact_lists.rst</title>
 <link rel="stylesheet" href="../input/data/html4css1.css" type="text/css" />
 </head>

Modified: trunk/docutils/test/functional/expected/dangerous.html
===================================================================
--- trunk/docutils/test/functional/expected/dangerous.html	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/test/functional/expected/dangerous.html	2025-11-06 03:36:16 UTC (rev 10260)
@@ -3,7 +3,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.4b1.dev: https://docutils.sourceforge.io/" />
 <title>dangerous.rst</title>
 <link rel="stylesheet" href="../input/data/html4css1.css" type="text/css" />
 </head>

Modified: trunk/docutils/test/functional/expected/field_name_limit.html
===================================================================
--- trunk/docutils/test/functional/expected/field_name_limit.html	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/test/functional/expected/field_name_limit.html	2025-11-06 03:36:16 UTC (rev 10260)
@@ -3,7 +3,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.4b1.dev: https://docutils.sourceforge.io/" />
 <title>field_list.rst</title>
 <link rel="stylesheet" href="../input/data/html4css1.css" type="text/css" />
 </head>

Modified: trunk/docutils/test/functional/expected/footnotes_html5.html
===================================================================
--- trunk/docutils/test/functional/expected/footnotes_html5.html	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/test/functional/expected/footnotes_html5.html	2025-11-06 03:36:16 UTC (rev 10260)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.4b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>Test footnote and citation rendering</title>
 <link rel="stylesheet" href="../input/data/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/length_units_html5.html
===================================================================
--- trunk/docutils/test/functional/expected/length_units_html5.html	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/test/functional/expected/length_units_html5.html	2025-11-06 03:36:16 UTC (rev 10260)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.4b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>Test length specifications</title>
 <link rel="stylesheet" href="../input/data/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/math_experiments_mathml.html
===================================================================
--- trunk/docutils/test/functional/expected/math_experiments_mathml.html	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/test/functional/expected/math_experiments_mathml.html	2025-11-06 03:36:16 UTC (rev 10260)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.4b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>Math Conversion Tests</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/math_experiments_mathml_blahtexml.html
===================================================================
--- trunk/docutils/test/functional/expected/math_experiments_mathml_blahtexml.html	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/test/functional/expected/math_experiments_mathml_blahtexml.html	2025-11-06 03:36:16 UTC (rev 10260)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.4b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>Math Conversion Tests</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/math_experiments_mathml_pandoc.html
===================================================================
--- trunk/docutils/test/functional/expected/math_experiments_mathml_pandoc.html	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/test/functional/expected/math_experiments_mathml_pandoc.html	2025-11-06 03:36:16 UTC (rev 10260)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.4b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>Math Conversion Tests</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/math_experiments_mathml_ttm.html
===================================================================
--- trunk/docutils/test/functional/expected/math_experiments_mathml_ttm.html	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/test/functional/expected/math_experiments_mathml_ttm.html	2025-11-06 03:36:16 UTC (rev 10260)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.4b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>Math Conversion Tests</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/math_output_html.html
===================================================================
--- trunk/docutils/test/functional/expected/math_output_html.html	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/test/functional/expected/math_output_html.html	2025-11-06 03:36:16 UTC (rev 10260)
@@ -3,7 +3,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.4b1.dev: https://docutils.sourceforge.io/" />
 <title>Mathematics</title>
 <link rel="stylesheet" href="../input/data/html4css1.css" type="text/css" />
 <link rel="stylesheet" href="../input/data/math.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/math_output_latex.html
===================================================================
--- trunk/docutils/test/functional/expected/math_output_latex.html	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/test/functional/expected/math_output_latex.html	2025-11-06 03:36:16 UTC (rev 10260)
@@ -3,7 +3,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.4b1.dev: https://docutils.sourceforge.io/" />
 <title>Mathematics</title>
 <link rel="stylesheet" href="../input/data/html4css1.css" type="text/css" />
 </head>

Modified: trunk/docutils/test/functional/expected/math_output_mathjax.html
===================================================================
--- trunk/docutils/test/functional/expected/math_output_mathjax.html	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/test/functional/expected/math_output_mathjax.html	2025-11-06 03:36:16 UTC (rev 10260)
@@ -3,7 +3,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.4b1.dev: https://docutils.sourceforge.io/" />
 <title>Mathematics</title>
 <script type="text/javascript" src="/usr/share/javascript/mathjax/MathJax.js?config=TeX-AMS_CHTML"></script>
 <link rel="stylesheet" href="../input/data/html4css1.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/math_output_mathml.html
===================================================================
--- trunk/docutils/test/functional/expected/math_output_mathml.html	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/test/functional/expected/math_output_mathml.html	2025-11-06 03:36:16 UTC (rev 10260)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.4b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>Mathematics</title>
 <link rel="stylesheet" href="../input/data/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/mathematics_mathml.html
===================================================================
--- trunk/docutils/test/functional/expected/mathematics_mathml.html	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/test/functional/expected/mathematics_mathml.html	2025-11-06 03:36:16 UTC (rev 10260)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.4b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>LaTeX syntax for mathematics</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/mathematics_mathml_blahtexml.html
===================================================================
--- trunk/docutils/test/functional/expected/mathematics_mathml_blahtexml.html	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/test/functional/expected/mathematics_mathml_blahtexml.html	2025-11-06 03:36:16 UTC (rev 10260)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.4b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>LaTeX syntax for mathematics</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/mathematics_mathml_pandoc.html
===================================================================
--- trunk/docutils/test/functional/expected/mathematics_mathml_pandoc.html	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/test/functional/expected/mathematics_mathml_pandoc.html	2025-11-06 03:36:16 UTC (rev 10260)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.4b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>LaTeX syntax for mathematics</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/mathematics_mathml_ttm.html
===================================================================
--- trunk/docutils/test/functional/expected/mathematics_mathml_ttm.html	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/test/functional/expected/mathematics_mathml_ttm.html	2025-11-06 03:36:16 UTC (rev 10260)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.4b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>LaTeX syntax for mathematics</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/misc_rst_html4css1.html
===================================================================
--- trunk/docutils/test/functional/expected/misc_rst_html4css1.html	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/test/functional/expected/misc_rst_html4css1.html	2025-11-06 03:36:16 UTC (rev 10260)
@@ -3,7 +3,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.4b1.dev: https://docutils.sourceforge.io/" />
 <title>Additional tests with html4css1</title>
 <link rel="stylesheet" href="foo&amp;bar.css" type="text/css" />
 <link rel="stylesheet" href="../input/data/html4css1.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/misc_rst_html5.html
===================================================================
--- trunk/docutils/test/functional/expected/misc_rst_html5.html	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/test/functional/expected/misc_rst_html5.html	2025-11-06 03:36:16 UTC (rev 10260)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.4b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>Additional tests with HTML 5</title>
 <link rel="stylesheet" href="../input/data/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/pep_html.html
===================================================================
--- trunk/docutils/test/functional/expected/pep_html.html	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/test/functional/expected/pep_html.html	2025-11-06 03:36:16 UTC (rev 10260)
@@ -8,7 +8,7 @@
 -->
 <head>
   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-  <meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
+  <meta name="generator" content="Docutils 0.22.4b1.dev: https://docutils.sourceforge.io/" />
   <title>PEP 100 - Test PEP</title>
   <link rel="stylesheet" href="../input/data/html4css1.css" type="text/css" />
 </head>

Modified: trunk/docutils/test/functional/expected/rst_html5_tuftig.html
===================================================================
--- trunk/docutils/test/functional/expected/rst_html5_tuftig.html	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/test/functional/expected/rst_html5_tuftig.html	2025-11-06 03:36:16 UTC (rev 10260)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.4b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>Special Features of the tuftig.css Stylesheet</title>
 <link rel="stylesheet" href="../input/data/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/standalone_rst_docutils_xml.xml
===================================================================
--- trunk/docutils/test/functional/expected/standalone_rst_docutils_xml.xml	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/test/functional/expected/standalone_rst_docutils_xml.xml	2025-11-06 03:36:16 UTC (rev 10260)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!DOCTYPE document PUBLIC "+//IDN docutils.sourceforge.net//DTD Docutils Generic//EN//XML" "http://docutils.sourceforge.net/docs/ref/docutils.dtd">
-<!-- Generated by Docutils 0.22.3 -->
+<!-- Generated by Docutils 0.22.4b1.dev -->
 <document ids="restructuredtext-test-document doctitle" names="restructuredtext\ test\ document doctitle" source="functional/input/standalone_rst_docutils_xml.rst" title="reStructuredText Test Document">
     <title>reStructuredText Test Document</title>
     <subtitle ids="examples-of-syntax-constructs subtitle" names="examples\ of\ syntax\ constructs subtitle">Examples of Syntax Constructs</subtitle>

Modified: trunk/docutils/test/functional/expected/standalone_rst_html4css1.html
===================================================================
--- trunk/docutils/test/functional/expected/standalone_rst_html4css1.html	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/test/functional/expected/standalone_rst_html4css1.html	2025-11-06 03:36:16 UTC (rev 10260)
@@ -3,7 +3,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.4b1.dev: https://docutils.sourceforge.io/" />
 <meta content="reStructuredText, test, parser" name="keywords" />
 <meta content="A test document, containing at least one example of each reStructuredText construct." lang="en" name="description" />
 <meta name="author" content="David Goodger" />

Modified: trunk/docutils/test/functional/expected/standalone_rst_html5.html
===================================================================
--- trunk/docutils/test/functional/expected/standalone_rst_html5.html	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/test/functional/expected/standalone_rst_html5.html	2025-11-06 03:36:16 UTC (rev 10260)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.4b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <meta content="reStructuredText, test, parser" name="keywords" />
 <meta content="A test document, containing at least one example of each reStructuredText construct." lang="en" name="description" xml:lang="en" />

Modified: trunk/docutils/test/functional/expected/standalone_rst_manpage.man
===================================================================
--- trunk/docutils/test/functional/expected/standalone_rst_manpage.man	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/test/functional/expected/standalone_rst_manpage.man	2025-11-06 03:36:16 UTC (rev 10260)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.3 manpage writer.
+.\" by the Docutils 0.22.4b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/docutils/test/functional/expected/standalone_rst_s5_html_1.html
===================================================================
--- trunk/docutils/test/functional/expected/standalone_rst_s5_html_1.html	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/test/functional/expected/standalone_rst_s5_html_1.html	2025-11-06 03:36:16 UTC (rev 10260)
@@ -3,7 +3,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.4b1.dev: https://docutils.sourceforge.io/" />
 <meta name="version" content="S5 1.1" />
 <meta name="author" content="David Goodger" />
 <meta name="date" content="2005-11-28" />

Modified: trunk/docutils/test/functional/expected/standalone_rst_s5_html_2.html
===================================================================
--- trunk/docutils/test/functional/expected/standalone_rst_s5_html_2.html	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/test/functional/expected/standalone_rst_s5_html_2.html	2025-11-06 03:36:16 UTC (rev 10260)
@@ -3,7 +3,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.4b1.dev: https://docutils.sourceforge.io/" />
 <meta name="version" content="S5 1.1" />
 <meta name="author" content="David Goodger" />
 <meta name="date" content="2005-11-28" />

Modified: trunk/docutils/test/test_writers/test_manpage.py
===================================================================
--- trunk/docutils/test/test_writers/test_manpage.py	2025-11-06 02:29:16 UTC (rev 10259)
+++ trunk/docutils/test/test_writers/test_manpage.py	2025-11-06 03:36:16 UTC (rev 10260)
@@ -96,7 +96,7 @@
 
 
 document_start = r""".\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.3 manpage writer.
+.\" by the Docutils 0.22.4b1.dev manpage writer.
 .
 """
 

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

[Docutils-checkins] SF.net SVN: docutils:[10259] tags/docutils-0.22.3 /

[<gr...@us...>]

Revision: 10259
          http://sourceforge.net/p/docutils/code/10259
Author:   grubert
Date:     2025-11-06 02:29:16 +0000 (Thu, 06 Nov 2025)
Log Message:
-----------
tagging release 0.22.3

Added Paths:
-----------
    tags/docutils-0.22.3/

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

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

[<gr...@us...>]

Revision: 10258
          http://sourceforge.net/p/docutils/code/10258
Author:   grubert
Date:     2025-11-06 02:17:08 +0000 (Thu, 06 Nov 2025)
Log Message:
-----------
version 0.22.3

Modified Paths:
--------------
    trunk/docutils/HISTORY.rst
    trunk/docutils/README.rst
    trunk/docutils/RELEASE-NOTES.rst
    trunk/docutils/docutils/__init__.py
    trunk/docutils/test/functional/expected/buggy_mathml.html
    trunk/docutils/test/functional/expected/buggy_mathml_blahtexml.html
    trunk/docutils/test/functional/expected/buggy_mathml_pandoc.html
    trunk/docutils/test/functional/expected/buggy_mathml_ttm.html
    trunk/docutils/test/functional/expected/compact_lists.html
    trunk/docutils/test/functional/expected/dangerous.html
    trunk/docutils/test/functional/expected/field_name_limit.html
    trunk/docutils/test/functional/expected/footnotes_html5.html
    trunk/docutils/test/functional/expected/length_units_html5.html
    trunk/docutils/test/functional/expected/math_experiments_mathml.html
    trunk/docutils/test/functional/expected/math_experiments_mathml_blahtexml.html
    trunk/docutils/test/functional/expected/math_experiments_mathml_pandoc.html
    trunk/docutils/test/functional/expected/math_experiments_mathml_ttm.html
    trunk/docutils/test/functional/expected/math_output_html.html
    trunk/docutils/test/functional/expected/math_output_latex.html
    trunk/docutils/test/functional/expected/math_output_mathjax.html
    trunk/docutils/test/functional/expected/math_output_mathml.html
    trunk/docutils/test/functional/expected/mathematics_mathml.html
    trunk/docutils/test/functional/expected/mathematics_mathml_blahtexml.html
    trunk/docutils/test/functional/expected/mathematics_mathml_pandoc.html
    trunk/docutils/test/functional/expected/mathematics_mathml_ttm.html
    trunk/docutils/test/functional/expected/misc_rst_html4css1.html
    trunk/docutils/test/functional/expected/misc_rst_html5.html
    trunk/docutils/test/functional/expected/pep_html.html
    trunk/docutils/test/functional/expected/rst_html5_tuftig.html
    trunk/docutils/test/functional/expected/standalone_rst_docutils_xml.xml
    trunk/docutils/test/functional/expected/standalone_rst_html4css1.html
    trunk/docutils/test/functional/expected/standalone_rst_html5.html
    trunk/docutils/test/functional/expected/standalone_rst_manpage.man
    trunk/docutils/test/functional/expected/standalone_rst_s5_html_1.html
    trunk/docutils/test/functional/expected/standalone_rst_s5_html_2.html
    trunk/docutils/test/test_writers/test_manpage.py

Modified: trunk/docutils/HISTORY.rst
===================================================================
--- trunk/docutils/HISTORY.rst	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/HISTORY.rst	2025-11-06 02:17:08 UTC (rev 10258)
@@ -14,8 +14,8 @@
 .. contents::
 
 
-Release 0.22.3b1.dev (unpublished)
-==================================
+Release 0.22.3 (2025-11-06)
+===========================
 
 * docutils/parsers/rst/directives/body.py,
   docutils/parsers/rst/directives/parts.py

Modified: trunk/docutils/README.rst
===================================================================
--- trunk/docutils/README.rst	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/README.rst	2025-11-06 02:17:08 UTC (rev 10258)
@@ -1,6 +1,6 @@
-===============================
- README: Docutils 0.22.3b1.dev
-===============================
+=========================
+ README: Docutils 0.22.3
+=========================
 
 :Author: David Goodger
 :Contact: go...@py...

Modified: trunk/docutils/RELEASE-NOTES.rst
===================================================================
--- trunk/docutils/RELEASE-NOTES.rst	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/RELEASE-NOTES.rst	2025-11-06 02:17:08 UTC (rev 10258)
@@ -263,8 +263,8 @@
    __ https://packages.debian.org/source/trixie/python-docutils
 
 
-Release 0.22.3b1.dev (unpublished)
-==================================
+Release 0.22.3 (2025-11-06)
+===========================
 
 Rst parser:
   - Ignore combining characters when parsing the grid table structure.

Modified: trunk/docutils/docutils/__init__.py
===================================================================
--- trunk/docutils/docutils/__init__.py	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/docutils/__init__.py	2025-11-06 02:17:08 UTC (rev 10258)
@@ -85,7 +85,7 @@
 
 __docformat__ = 'reStructuredText'
 
-__version__ = '0.22.3b1.dev'
+__version__ = '0.22.3'
 """Docutils version identifier (complies with PEP 440)::
 
     major.minor[.micro][releaselevel[serial]][.dev]
@@ -160,9 +160,9 @@
     major=0,
     minor=22,
     micro=3,
-    releaselevel='beta',  # one of 'alpha', 'beta', 'candidate', 'final'
-    serial=1,  # pre-release number (0 for final releases and snapshots)
-    release=False  # True for official releases and pre-releases
+    releaselevel='final',  # one of 'alpha', 'beta', 'candidate', 'final'
+    serial=0,  # pre-release number (0 for final releases and snapshots)
+    release=True  # True for official releases and pre-releases
     )
 """Comprehensive version information tuple.
 

Modified: trunk/docutils/test/functional/expected/buggy_mathml.html
===================================================================
--- trunk/docutils/test/functional/expected/buggy_mathml.html	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/test/functional/expected/buggy_mathml.html	2025-11-06 02:17:08 UTC (rev 10258)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>buggy-maths</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/buggy_mathml_blahtexml.html
===================================================================
--- trunk/docutils/test/functional/expected/buggy_mathml_blahtexml.html	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/test/functional/expected/buggy_mathml_blahtexml.html	2025-11-06 02:17:08 UTC (rev 10258)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>buggy-maths</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/buggy_mathml_pandoc.html
===================================================================
--- trunk/docutils/test/functional/expected/buggy_mathml_pandoc.html	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/test/functional/expected/buggy_mathml_pandoc.html	2025-11-06 02:17:08 UTC (rev 10258)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>buggy-maths</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/buggy_mathml_ttm.html
===================================================================
--- trunk/docutils/test/functional/expected/buggy_mathml_ttm.html	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/test/functional/expected/buggy_mathml_ttm.html	2025-11-06 02:17:08 UTC (rev 10258)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>buggy-maths</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/compact_lists.html
===================================================================
--- trunk/docutils/test/functional/expected/compact_lists.html	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/test/functional/expected/compact_lists.html	2025-11-06 02:17:08 UTC (rev 10258)
@@ -3,7 +3,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
 <title>compact_lists.rst</title>
 <link rel="stylesheet" href="../input/data/html4css1.css" type="text/css" />
 </head>

Modified: trunk/docutils/test/functional/expected/dangerous.html
===================================================================
--- trunk/docutils/test/functional/expected/dangerous.html	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/test/functional/expected/dangerous.html	2025-11-06 02:17:08 UTC (rev 10258)
@@ -3,7 +3,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
 <title>dangerous.rst</title>
 <link rel="stylesheet" href="../input/data/html4css1.css" type="text/css" />
 </head>

Modified: trunk/docutils/test/functional/expected/field_name_limit.html
===================================================================
--- trunk/docutils/test/functional/expected/field_name_limit.html	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/test/functional/expected/field_name_limit.html	2025-11-06 02:17:08 UTC (rev 10258)
@@ -3,7 +3,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
 <title>field_list.rst</title>
 <link rel="stylesheet" href="../input/data/html4css1.css" type="text/css" />
 </head>

Modified: trunk/docutils/test/functional/expected/footnotes_html5.html
===================================================================
--- trunk/docutils/test/functional/expected/footnotes_html5.html	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/test/functional/expected/footnotes_html5.html	2025-11-06 02:17:08 UTC (rev 10258)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>Test footnote and citation rendering</title>
 <link rel="stylesheet" href="../input/data/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/length_units_html5.html
===================================================================
--- trunk/docutils/test/functional/expected/length_units_html5.html	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/test/functional/expected/length_units_html5.html	2025-11-06 02:17:08 UTC (rev 10258)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>Test length specifications</title>
 <link rel="stylesheet" href="../input/data/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/math_experiments_mathml.html
===================================================================
--- trunk/docutils/test/functional/expected/math_experiments_mathml.html	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/test/functional/expected/math_experiments_mathml.html	2025-11-06 02:17:08 UTC (rev 10258)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>Math Conversion Tests</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/math_experiments_mathml_blahtexml.html
===================================================================
--- trunk/docutils/test/functional/expected/math_experiments_mathml_blahtexml.html	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/test/functional/expected/math_experiments_mathml_blahtexml.html	2025-11-06 02:17:08 UTC (rev 10258)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>Math Conversion Tests</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/math_experiments_mathml_pandoc.html
===================================================================
--- trunk/docutils/test/functional/expected/math_experiments_mathml_pandoc.html	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/test/functional/expected/math_experiments_mathml_pandoc.html	2025-11-06 02:17:08 UTC (rev 10258)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>Math Conversion Tests</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/math_experiments_mathml_ttm.html
===================================================================
--- trunk/docutils/test/functional/expected/math_experiments_mathml_ttm.html	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/test/functional/expected/math_experiments_mathml_ttm.html	2025-11-06 02:17:08 UTC (rev 10258)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>Math Conversion Tests</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/math_output_html.html
===================================================================
--- trunk/docutils/test/functional/expected/math_output_html.html	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/test/functional/expected/math_output_html.html	2025-11-06 02:17:08 UTC (rev 10258)
@@ -3,7 +3,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
 <title>Mathematics</title>
 <link rel="stylesheet" href="../input/data/html4css1.css" type="text/css" />
 <link rel="stylesheet" href="../input/data/math.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/math_output_latex.html
===================================================================
--- trunk/docutils/test/functional/expected/math_output_latex.html	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/test/functional/expected/math_output_latex.html	2025-11-06 02:17:08 UTC (rev 10258)
@@ -3,7 +3,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
 <title>Mathematics</title>
 <link rel="stylesheet" href="../input/data/html4css1.css" type="text/css" />
 </head>

Modified: trunk/docutils/test/functional/expected/math_output_mathjax.html
===================================================================
--- trunk/docutils/test/functional/expected/math_output_mathjax.html	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/test/functional/expected/math_output_mathjax.html	2025-11-06 02:17:08 UTC (rev 10258)
@@ -3,7 +3,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
 <title>Mathematics</title>
 <script type="text/javascript" src="/usr/share/javascript/mathjax/MathJax.js?config=TeX-AMS_CHTML"></script>
 <link rel="stylesheet" href="../input/data/html4css1.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/math_output_mathml.html
===================================================================
--- trunk/docutils/test/functional/expected/math_output_mathml.html	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/test/functional/expected/math_output_mathml.html	2025-11-06 02:17:08 UTC (rev 10258)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>Mathematics</title>
 <link rel="stylesheet" href="../input/data/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/mathematics_mathml.html
===================================================================
--- trunk/docutils/test/functional/expected/mathematics_mathml.html	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/test/functional/expected/mathematics_mathml.html	2025-11-06 02:17:08 UTC (rev 10258)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>LaTeX syntax for mathematics</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/mathematics_mathml_blahtexml.html
===================================================================
--- trunk/docutils/test/functional/expected/mathematics_mathml_blahtexml.html	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/test/functional/expected/mathematics_mathml_blahtexml.html	2025-11-06 02:17:08 UTC (rev 10258)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>LaTeX syntax for mathematics</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/mathematics_mathml_pandoc.html
===================================================================
--- trunk/docutils/test/functional/expected/mathematics_mathml_pandoc.html	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/test/functional/expected/mathematics_mathml_pandoc.html	2025-11-06 02:17:08 UTC (rev 10258)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>LaTeX syntax for mathematics</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/mathematics_mathml_ttm.html
===================================================================
--- trunk/docutils/test/functional/expected/mathematics_mathml_ttm.html	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/test/functional/expected/mathematics_mathml_ttm.html	2025-11-06 02:17:08 UTC (rev 10258)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>LaTeX syntax for mathematics</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/misc_rst_html4css1.html
===================================================================
--- trunk/docutils/test/functional/expected/misc_rst_html4css1.html	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/test/functional/expected/misc_rst_html4css1.html	2025-11-06 02:17:08 UTC (rev 10258)
@@ -3,7 +3,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
 <title>Additional tests with html4css1</title>
 <link rel="stylesheet" href="foo&amp;bar.css" type="text/css" />
 <link rel="stylesheet" href="../input/data/html4css1.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/misc_rst_html5.html
===================================================================
--- trunk/docutils/test/functional/expected/misc_rst_html5.html	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/test/functional/expected/misc_rst_html5.html	2025-11-06 02:17:08 UTC (rev 10258)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>Additional tests with HTML 5</title>
 <link rel="stylesheet" href="../input/data/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/pep_html.html
===================================================================
--- trunk/docutils/test/functional/expected/pep_html.html	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/test/functional/expected/pep_html.html	2025-11-06 02:17:08 UTC (rev 10258)
@@ -8,7 +8,7 @@
 -->
 <head>
   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-  <meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
+  <meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
   <title>PEP 100 - Test PEP</title>
   <link rel="stylesheet" href="../input/data/html4css1.css" type="text/css" />
 </head>

Modified: trunk/docutils/test/functional/expected/rst_html5_tuftig.html
===================================================================
--- trunk/docutils/test/functional/expected/rst_html5_tuftig.html	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/test/functional/expected/rst_html5_tuftig.html	2025-11-06 02:17:08 UTC (rev 10258)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>Special Features of the tuftig.css Stylesheet</title>
 <link rel="stylesheet" href="../input/data/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/standalone_rst_docutils_xml.xml
===================================================================
--- trunk/docutils/test/functional/expected/standalone_rst_docutils_xml.xml	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/test/functional/expected/standalone_rst_docutils_xml.xml	2025-11-06 02:17:08 UTC (rev 10258)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!DOCTYPE document PUBLIC "+//IDN docutils.sourceforge.net//DTD Docutils Generic//EN//XML" "http://docutils.sourceforge.net/docs/ref/docutils.dtd">
-<!-- Generated by Docutils 0.22.3b1.dev -->
+<!-- Generated by Docutils 0.22.3 -->
 <document ids="restructuredtext-test-document doctitle" names="restructuredtext\ test\ document doctitle" source="functional/input/standalone_rst_docutils_xml.rst" title="reStructuredText Test Document">
     <title>reStructuredText Test Document</title>
     <subtitle ids="examples-of-syntax-constructs subtitle" names="examples\ of\ syntax\ constructs subtitle">Examples of Syntax Constructs</subtitle>

Modified: trunk/docutils/test/functional/expected/standalone_rst_html4css1.html
===================================================================
--- trunk/docutils/test/functional/expected/standalone_rst_html4css1.html	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/test/functional/expected/standalone_rst_html4css1.html	2025-11-06 02:17:08 UTC (rev 10258)
@@ -3,7 +3,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
 <meta content="reStructuredText, test, parser" name="keywords" />
 <meta content="A test document, containing at least one example of each reStructuredText construct." lang="en" name="description" />
 <meta name="author" content="David Goodger" />

Modified: trunk/docutils/test/functional/expected/standalone_rst_html5.html
===================================================================
--- trunk/docutils/test/functional/expected/standalone_rst_html5.html	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/test/functional/expected/standalone_rst_html5.html	2025-11-06 02:17:08 UTC (rev 10258)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <meta content="reStructuredText, test, parser" name="keywords" />
 <meta content="A test document, containing at least one example of each reStructuredText construct." lang="en" name="description" xml:lang="en" />

Modified: trunk/docutils/test/functional/expected/standalone_rst_manpage.man
===================================================================
--- trunk/docutils/test/functional/expected/standalone_rst_manpage.man	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/test/functional/expected/standalone_rst_manpage.man	2025-11-06 02:17:08 UTC (rev 10258)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.3b1.dev manpage writer.
+.\" by the Docutils 0.22.3 manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/docutils/test/functional/expected/standalone_rst_s5_html_1.html
===================================================================
--- trunk/docutils/test/functional/expected/standalone_rst_s5_html_1.html	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/test/functional/expected/standalone_rst_s5_html_1.html	2025-11-06 02:17:08 UTC (rev 10258)
@@ -3,7 +3,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
 <meta name="version" content="S5 1.1" />
 <meta name="author" content="David Goodger" />
 <meta name="date" content="2005-11-28" />

Modified: trunk/docutils/test/functional/expected/standalone_rst_s5_html_2.html
===================================================================
--- trunk/docutils/test/functional/expected/standalone_rst_s5_html_2.html	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/test/functional/expected/standalone_rst_s5_html_2.html	2025-11-06 02:17:08 UTC (rev 10258)
@@ -3,7 +3,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3: https://docutils.sourceforge.io/" />
 <meta name="version" content="S5 1.1" />
 <meta name="author" content="David Goodger" />
 <meta name="date" content="2005-11-28" />

Modified: trunk/docutils/test/test_writers/test_manpage.py
===================================================================
--- trunk/docutils/test/test_writers/test_manpage.py	2025-11-04 09:02:20 UTC (rev 10257)
+++ trunk/docutils/test/test_writers/test_manpage.py	2025-11-06 02:17:08 UTC (rev 10258)
@@ -96,7 +96,7 @@
 
 
 document_start = r""".\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.3b1.dev manpage writer.
+.\" by the Docutils 0.22.3 manpage writer.
 .
 """
 

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

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

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

Revision: 10257
          http://sourceforge.net/p/docutils/code/10257
Author:   milde
Date:     2025-11-04 09:02:20 +0000 (Tue, 04 Nov 2025)
Log Message:
-----------
Small edits in description of recent changes.

Rephrase and rearrange the description of changes in the HISTORY and RELEASE-NOTES.

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

Modified: trunk/docutils/HISTORY.rst
===================================================================
--- trunk/docutils/HISTORY.rst	2025-11-02 17:51:21 UTC (rev 10256)
+++ trunk/docutils/HISTORY.rst	2025-11-04 09:02:20 UTC (rev 10257)
@@ -20,19 +20,20 @@
 * docutils/parsers/rst/directives/body.py,
   docutils/parsers/rst/directives/parts.py
 
-  - Ignore auxiliary elements like `sphinx.addnodes.only`
+  - Do not flag uncategorized, auxiliary elements like `sphinx.addnodes.only`
     when testing for invalid parents of topics or sidebars
     (cf. https://github.com/sphinx-doc/sphinx/issues/14002).
 
 * docutils/parsers/rst/states.py
 
-  - Ignore combining characters when extracting a grid table block
   - More informative error messages when a substitution definition contains
     problematic or not supported content.
+  - Ignore combining characters when extracting a grid table block
 
 * docutils/parsers/rst/tableparser.py
 
   - Ignore combining characters when parsing the grid table structure.
+    Fixes bugs #128 and #512.
 
 * docutils/statemachine.py
 

Modified: trunk/docutils/RELEASE-NOTES.rst
===================================================================
--- trunk/docutils/RELEASE-NOTES.rst	2025-11-02 17:51:21 UTC (rev 10256)
+++ trunk/docutils/RELEASE-NOTES.rst	2025-11-04 09:02:20 UTC (rev 10257)
@@ -267,10 +267,9 @@
 ==================================
 
 Rst parser:
-  - Allow for combining characters in grid tables.
-    Fixes bugs #128 and #512.
+  - Ignore combining characters when parsing the grid table structure.
 
-  - Ignore auxiliary elements like `sphinx.addnodes.only`
+  - Allow for auxiliary elements like `sphinx.addnodes.only`
     when testing for invalid parents of topics or sidebars.
 
 

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

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

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

Revision: 10256
          http://sourceforge.net/p/docutils/code/10256
Author:   milde
Date:     2025-11-02 17:51:21 +0000 (Sun, 02 Nov 2025)
Log Message:
-----------
Relax test for valid parents of topics or sidebars.

Raise error if the parent element belongs to a not-allowed parent class
instead of when the parent element is not in a supported parent class.
The difference is with uncategorized parent classes (like `node.Element`
or `sphinx.addnodes.only`). This allows for auxiliary wrappers during
the parsing step and fixes issues with the Sphinx "only" directive.

cf. https://github.com/sphinx-doc/sphinx/issues/14002

Modified Paths:
--------------
    trunk/docutils/HISTORY.rst
    trunk/docutils/RELEASE-NOTES.rst
    trunk/docutils/docutils/parsers/rst/directives/body.py
    trunk/docutils/docutils/parsers/rst/directives/parts.py
    trunk/docutils/docutils/writers/html5_polyglot/responsive.css
    trunk/docutils/test/test_parsers/test_rst/test_directives/test_sidebars.py

Modified: trunk/docutils/HISTORY.rst
===================================================================
--- trunk/docutils/HISTORY.rst	2025-11-02 17:51:07 UTC (rev 10255)
+++ trunk/docutils/HISTORY.rst	2025-11-02 17:51:21 UTC (rev 10256)
@@ -17,6 +17,13 @@
 Release 0.22.3b1.dev (unpublished)
 ==================================
 
+* docutils/parsers/rst/directives/body.py,
+  docutils/parsers/rst/directives/parts.py
+
+  - Ignore auxiliary elements like `sphinx.addnodes.only`
+    when testing for invalid parents of topics or sidebars
+    (cf. https://github.com/sphinx-doc/sphinx/issues/14002).
+
 * docutils/parsers/rst/states.py
 
   - Ignore combining characters when extracting a grid table block

Modified: trunk/docutils/RELEASE-NOTES.rst
===================================================================
--- trunk/docutils/RELEASE-NOTES.rst	2025-11-02 17:51:07 UTC (rev 10255)
+++ trunk/docutils/RELEASE-NOTES.rst	2025-11-02 17:51:21 UTC (rev 10256)
@@ -267,10 +267,13 @@
 ==================================
 
 Rst parser:
-  Allow for combining characters in grid tables.
-  Fixes bugs #128 and #512.
+  - Allow for combining characters in grid tables.
+    Fixes bugs #128 and #512.
 
+  - Ignore auxiliary elements like `sphinx.addnodes.only`
+    when testing for invalid parents of topics or sidebars.
 
+
 Release 0.22.2 (2025-09-20)
 ===========================
 

Modified: trunk/docutils/docutils/parsers/rst/directives/body.py
===================================================================
--- trunk/docutils/docutils/parsers/rst/directives/body.py	2025-11-02 17:51:07 UTC (rev 10255)
+++ trunk/docutils/docutils/parsers/rst/directives/body.py	2025-11-02 17:51:21 UTC (rev 10256)
@@ -29,9 +29,18 @@
     node_class = None
     """Node class to be used (must be set in subclasses)."""
 
+    invalid_parents = (nodes.SubStructural, nodes.Bibliographic,
+                       nodes.Decorative, nodes.Body, nodes.Part, nodes.topic)
+    """
+    Node categories where topics and sidebars are invalid children.
+
+    Sidebars are only valid in <document> and <section> elements,
+    topics also in <sidebar> elements. However, during parsing,
+    there may be wrapper nodes (like `sphinx.addnodes.only`).
+    """
+
     def run(self):
-        if not isinstance(self.state_machine.node,
-                          (nodes.document, nodes.section, nodes.sidebar)):
+        if isinstance(self.state_machine.node, self.invalid_parents):
             raise self.error('The "%s" directive may not be used within '
                              'topics or body elements.' % self.name)
         self.assert_has_content()

Modified: trunk/docutils/docutils/parsers/rst/directives/parts.py
===================================================================
--- trunk/docutils/docutils/parsers/rst/directives/parts.py	2025-11-02 17:51:07 UTC (rev 10255)
+++ trunk/docutils/docutils/parsers/rst/directives/parts.py	2025-11-02 17:51:21 UTC (rev 10256)
@@ -12,6 +12,7 @@
 from docutils.transforms import parts
 from docutils.parsers.rst import Directive
 from docutils.parsers.rst import directives
+from docutils.parsers.rst.directives.body import BasePseudoSection
 
 
 class Contents(Directive):
@@ -43,8 +44,8 @@
                    'class': directives.class_option}
 
     def run(self):
-        if not isinstance(self.state_machine.node,
-                          (nodes.document, nodes.section, nodes.sidebar)):
+        if isinstance(self.state_machine.node,
+                      BasePseudoSection.invalid_parents):
             raise self.error('The "%s" directive may not be used within '
                              'topics or body elements.' % self.name)
         document = self.state_machine.document

Modified: trunk/docutils/docutils/writers/html5_polyglot/responsive.css
===================================================================
--- trunk/docutils/docutils/writers/html5_polyglot/responsive.css	2025-11-02 17:51:07 UTC (rev 10255)
+++ trunk/docutils/docutils/writers/html5_polyglot/responsive.css	2025-11-02 17:51:21 UTC (rev 10256)
@@ -72,7 +72,12 @@
 pre, dd, dl.option-list {
   margin-left: calc(2% + 1em);
 }
+/* but not in a table cell */
+td pre, td dl.option-list {
+  margin-left: 0;
+}
 
+
 /* Object styling */
 /* ============== */
 
@@ -201,6 +206,8 @@
   text-align: left;
   vertical-align: baseline;
 }
+td *:first-child { margin-top: 0; }
+td *:last-child { margin-bottom: 0; }
 table.booktabs { /* "booktabs" style (no vertical lines) */
   border-top: 2px solid;
   border-bottom: 2px solid;

Modified: trunk/docutils/test/test_parsers/test_rst/test_directives/test_sidebars.py
===================================================================
--- trunk/docutils/test/test_parsers/test_rst/test_directives/test_sidebars.py	2025-11-02 17:51:07 UTC (rev 10255)
+++ trunk/docutils/test/test_parsers/test_rst/test_directives/test_sidebars.py	2025-11-02 17:51:21 UTC (rev 10256)
@@ -23,6 +23,8 @@
 
 
 class ParserTestCase(unittest.TestCase):
+    maxDiff = None
+
     def test_parser(self):
         parser = Parser()
         settings = get_default_settings(Parser)

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

[Docutils-checkins] SF.net SVN: docutils:[10255] trunk/docutils/docs/ref

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

Revision: 10255
          http://sourceforge.net/p/docutils/code/10255
Author:   milde
Date:     2025-11-02 17:51:07 +0000 (Sun, 02 Nov 2025)
Log Message:
-----------
Documentation update/fixes.

Correct description of refid: refers to another element by
*one of its* identifiers. Add XPath example.

Correct description of valid parents for "topic" and "content"
directives.

Modified Paths:
--------------
    trunk/docutils/docs/ref/doctree.rst
    trunk/docutils/docs/ref/rst/directives.rst

Modified: trunk/docutils/docs/ref/doctree.rst
===================================================================
--- trunk/docutils/docs/ref/doctree.rst	2025-11-02 17:50:57 UTC (rev 10254)
+++ trunk/docutils/docs/ref/doctree.rst	2025-11-02 17:51:07 UTC (rev 10255)
@@ -4469,7 +4469,7 @@
   | Used in the `classes`_ attribute.  Python data type: ``list[str]``.
 
 _`%idref.type`
-  | A reference to another element by its identifier_.
+  | A reference to another element by one of its identifiers_.
     Resolves to NMTOKEN_. [#id-vc]_
   | Used in the `refid`_ attribute.  Python data type: ``str``.
 
@@ -4803,12 +4803,20 @@
 unique `identifiers`_, typically assigned by the system.
 It is one of the `common attributes`_, shared by all Docutils elements.
 
+An XPath_ expression to select the element with identifier `test` is ::
+
+  //*[contains(concat(' ', @ids, ' '), ' test ')]
+
+(similar to `selecting an element by CSS class`__).
+
 .. TODO:
    * Use 'id' for primary identifier key?
    * Keep additional keys in `ids`
      or in the preceding target elements?
 
+__ https://stackoverflow.com/questions/1604471/how-can-i-find-an-element-by-css-class-with-xpath
 
+
 ``level``
 =========
 
@@ -4984,8 +4992,8 @@
 
 Attribute type: `%idref.type`_.  Default value: none.
 
-The ``refid`` attribute contains a reference to another element via its
-`identifier`_.
+The ``refid`` attribute contains a reference to another element via
+one of its `identifiers`_.
 It is used by the `\<citation_reference>`_, `\<footnote_reference>`_,
 `\<problematic>`_, `\<reference>`_, `\<target>`_, and `\<title>`_ elements
 (via the `%refid.att`_ and `%reference.atts`_ parameter entities).
@@ -5886,6 +5894,7 @@
 .. _external DTD subset: https://www.w3.org/TR/xml11/#sec-external-ent
 .. _XML attribute types: https://www.w3.org/TR/REC-xml/#sec-attribute-types
 .. _One ID per Element Type: https://www.w3.org/TR/REC-xml/#one-id-per-el
+.. _XPath: https://www.w3.org/TR/xpath/
 
 .. _Docutils: https://docutils.sourceforge.io/
 .. _docutils.nodes:

Modified: trunk/docutils/docs/ref/rst/directives.rst
===================================================================
--- trunk/docutils/docs/ref/rst/directives.rst	2025-11-02 17:50:57 UTC (rev 10254)
+++ trunk/docutils/docs/ref/rst/directives.rst	2025-11-02 17:51:07 UTC (rev 10255)
@@ -453,8 +453,8 @@
 A topic is like a block quote with a title, or a self-contained
 section with no subsections.  Use the "topic" directive to indicate a
 self-contained idea that is separate from the flow of the document.
-Topics may occur anywhere a section or transition may occur.  Body
-elements and topics may not contain nested topics.
+Topics may occur anywhere a section or transition may occur and
+in sidebars.  Body elements and topics may not contain nested topics.
 
 The directive's sole argument is interpreted as the topic title; the
 next line must be blank.  All subsequent lines make up the topic body,
@@ -1173,7 +1173,7 @@
 
 The "contents" directive generates a table of contents (TOC) in
 a `\<topic>`_ element.  Topics, and therefore tables of contents,
-may occur anywhere a section or transition may occur.
+may occur anywhere a section or transition may occur and in sidebars.
 Body elements and topics may not contain tables of contents.
 
 Here's the directive in its simplest form::

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

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

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

Revision: 10254
          http://sourceforge.net/p/docutils/code/10254
Author:   milde
Date:     2025-11-02 17:50:57 +0000 (Sun, 02 Nov 2025)
Log Message:
-----------
Better error message for substitution definitions.

More informative and easier to comprehend error messages when a
substitution definition contains problematic or not supported content.

Document limits to content of substitution definitions.

Modified Paths:
--------------
    trunk/docutils/HISTORY.rst
    trunk/docutils/docs/ref/rst/directives.rst
    trunk/docutils/docutils/parsers/rst/states.py
    trunk/docutils/test/test_parsers/test_rst/test_directives/test_replace.py
    trunk/docutils/test/test_parsers/test_rst/test_substitutions.py
    trunk/docutils/test/test_transforms/test_hyperlinks.py
    trunk/docutils/test/test_transforms/test_substitutions.py

Modified: trunk/docutils/HISTORY.rst
===================================================================
--- trunk/docutils/HISTORY.rst	2025-10-06 12:29:47 UTC (rev 10253)
+++ trunk/docutils/HISTORY.rst	2025-11-02 17:50:57 UTC (rev 10254)
@@ -20,6 +20,8 @@
 * docutils/parsers/rst/states.py
 
   - Ignore combining characters when extracting a grid table block
+  - More informative error messages when a substitution definition contains
+    problematic or not supported content.
 
 * docutils/parsers/rst/tableparser.py
 

Modified: trunk/docutils/docs/ref/rst/directives.rst
===================================================================
--- trunk/docutils/docs/ref/rst/directives.rst	2025-10-06 12:29:47 UTC (rev 10253)
+++ trunk/docutils/docs/ref/rst/directives.rst	2025-11-02 17:50:57 UTC (rev 10254)
@@ -259,7 +259,7 @@
 .. _image options:
 
 The "image" directive recognizes the common options `class <class option_>`_
-and name_ as well as
+and name_ [#no-inline-name]_ as well as
 
 ``align`` : "top", "middle", "bottom", "left", "center", or "right"
     The alignment of the image, equivalent to the HTML ``<img>`` tag's
@@ -1424,9 +1424,12 @@
 
 The `image`_ directive can be used both, stand-alone (to define
 block-level images) and in substitution definitions to define
-inline images.
+inline images. [#no-inline-name]_
 
+.. [#no-inline-name] The name_ option cannot be used in
+                     a substitution definition. [#substitution-limits]_
 
+
 .. _replace:
 
 Replacement Text
@@ -1435,7 +1438,7 @@
 .. class:: field-indent-13em
 
 :Directive Type: "replace"
-:Doctree Element: Text & `inline elements`_
+:Doctree Element: Text & `inline elements`_ [#substitution-limits]_
 :Directive Arguments: none
 :Directive Options: none
 :Directive Content: A single paragraph; may contain inline markup.
@@ -1461,7 +1464,14 @@
     .. |Python| replace:: Python, *the* best language around
     .. _Python: https://www.python.org/
 
+.. [#substitution-limits] As a substitution may be referenced more than
+   one time, a substitution definition may not contain references to
+   `anonymous hyperlinks`_, `auto-numbered`_ or `auto-symbol`_ footnotes
+   and no `hyperlink targets`__ (names and identifiers must be unique).
 
+   __ restructuredtext.html#inline-internal-targets
+
+
 .. _unicode:
 
 Unicode Character Codes
@@ -2312,6 +2322,9 @@
     https://docs.python.org/3/library/codecs.html#standard-encodings
 
 .. _reStructuredText Markup Specification: restructuredtext.html
+.. _anonymous hyperlinks: restructuredtext.html#anonymous-hyperlinks
+.. _auto-numbered: restructuredtext.html#auto-numbered-footnotes
+.. _auto-symbol: restructuredtext.html#auto-symbol-footnotes
 .. _block quote: restructuredtext.html#block-quotes
 .. _citation references: restructuredtext.html#citation-references
 .. _citation: restructuredtext.html#citations

Modified: trunk/docutils/docutils/parsers/rst/states.py
===================================================================
--- trunk/docutils/docutils/parsers/rst/states.py	2025-10-06 12:29:47 UTC (rev 10253)
+++ trunk/docutils/docutils/parsers/rst/states.py	2025-11-02 17:50:57 UTC (rev 10254)
@@ -2189,15 +2189,23 @@
                 del substitution_node[i]
             else:
                 i += 1
-        for node in substitution_node.findall(nodes.Element):
-            if self.disallowed_inside_substitution_definitions(node):
-                pformat = nodes.literal_block('', node.pformat().rstrip())
+        for node in substitution_node.findall(nodes.Element,
+                                              include_self=False):
+            if isinstance(node, nodes.problematic):
                 msg = self.reporter.error(
-                    'Substitution definition contains illegal element <%s>:'
-                    % node.tagname,
-                    pformat, nodes.literal_block(blocktext, blocktext),
+                    'Problematic content in substitution definition',
+                    nodes.literal_block('', blocktext),
                     source=src, line=srcline)
+                msg.append(nodes.block_quote(
+                    '', nodes.paragraph('', '', *substitution_node.children)))
                 return [msg], blank_finish
+            illegal = self.disallowed_inside_substitution_definitions(node)
+            if illegal:
+                msg = self.reporter.error(f'{illegal} are not supported in '
+                                          'a substitution definition.',
+                                          nodes.literal_block('', blocktext),
+                                          source=src, line=srcline)
+                return [msg], blank_finish
         if len(substitution_node) == 0:
             msg = self.reporter.warning(
                   'Substitution definition "%s" empty or invalid.' % subname,
@@ -2208,13 +2216,15 @@
             substitution_node, subname, self.parent)
         return [substitution_node], blank_finish
 
-    def disallowed_inside_substitution_definitions(self, node) -> bool:
-        if (node['ids']
-            or isinstance(node, nodes.reference) and node.get('anonymous')
-            or isinstance(node, nodes.footnote_reference) and node.get('auto')):  # noqa: E501
-            return True
+    def disallowed_inside_substitution_definitions(self, node) -> str:
+        if isinstance(node, nodes.reference) and node.get('anonymous'):
+            return 'Anonymous references'
+        if isinstance(node, nodes.footnote_reference) and node.get('auto'):
+            return 'References to auto-numbered and auto-symbol footnotes'
+        if node['names'] or node['ids']:
+            return 'Targets (names and identifiers)'
         else:
-            return False
+            return ''
 
     def directive(self, match, **option_presets):
         """Returns a 2-tuple: list of nodes, and a "blank finish" boolean."""

Modified: trunk/docutils/test/test_parsers/test_rst/test_directives/test_replace.py
===================================================================
--- trunk/docutils/test/test_parsers/test_rst/test_directives/test_replace.py	2025-10-06 12:29:47 UTC (rev 10253)
+++ trunk/docutils/test/test_parsers/test_rst/test_directives/test_replace.py	2025-11-02 17:50:57 UTC (rev 10254)
@@ -23,6 +23,8 @@
 
 
 class ParserTestCase(unittest.TestCase):
+    maxDiff = None
+
     def test_parser(self):
         parser = Parser()
         settings = get_default_settings(Parser)
@@ -129,12 +131,20 @@
             Inline literal start-string without end-string.
     <system_message level="3" line="1" source="test data" type="ERROR">
         <paragraph>
-            Substitution definition contains illegal element <problematic>:
+            Problematic content in substitution definition
         <literal_block xml:space="preserve">
-            <problematic ids="problematic-1" refid="system-message-1">
-                *
-        <literal_block xml:space="preserve">
             .. |name| replace::  *error in **inline ``markup
+        <block_quote>
+            <paragraph>
+                <problematic ids="problematic-1" refid="system-message-1">
+                    *
+                error in \n\
+                <problematic ids="problematic-2" refid="system-message-2">
+                    **
+                inline \n\
+                <problematic ids="problematic-3" refid="system-message-3">
+                    ``
+                markup
 """],
 ["""\
 .. replace:: not valid outside of a substitution definition

Modified: trunk/docutils/test/test_parsers/test_rst/test_substitutions.py
===================================================================
--- trunk/docutils/test/test_parsers/test_rst/test_substitutions.py	2025-10-06 12:29:47 UTC (rev 10253)
+++ trunk/docutils/test/test_parsers/test_rst/test_substitutions.py	2025-11-02 17:50:57 UTC (rev 10254)
@@ -23,6 +23,8 @@
 
 
 class ParserTestCase(unittest.TestCase):
+    maxDiff = None
+
     def test_parser(self):
         parser = Parser()
         settings = get_default_settings(Parser)
@@ -287,26 +289,18 @@
         Elements that are prohibited inside of substitution definitions:
     <system_message level="3" line="3" source="test data" type="ERROR">
         <paragraph>
-            Substitution definition contains illegal element <target>:
+            Targets (names and identifiers) are not supported in a substitution definition.
         <literal_block xml:space="preserve">
-            <target ids="target" names="target">
-                target
-        <literal_block xml:space="preserve">
             .. |target| replace:: _`target`
     <system_message level="3" line="4" source="test data" type="ERROR">
         <paragraph>
-            Substitution definition contains illegal element <reference>:
+            Anonymous references are not supported in a substitution definition.
         <literal_block xml:space="preserve">
-            <reference anonymous="1" name="anonymous">
-                anonymous
-        <literal_block xml:space="preserve">
             .. |reference| replace:: anonymous__
     <system_message level="3" line="5" source="test data" type="ERROR">
         <paragraph>
-            Substitution definition contains illegal element <footnote_reference>:
+            References to auto-numbered and auto-symbol footnotes are not supported in a substitution definition.
         <literal_block xml:space="preserve">
-            <footnote_reference auto="1" ids="footnote-reference-1">
-        <literal_block xml:space="preserve">
             .. |auto-numbered footnote| replace:: [#]_
 """],
 ]

Modified: trunk/docutils/test/test_transforms/test_hyperlinks.py
===================================================================
--- trunk/docutils/test/test_transforms/test_hyperlinks.py	2025-10-06 12:29:47 UTC (rev 10253)
+++ trunk/docutils/test/test_transforms/test_hyperlinks.py	2025-11-02 17:50:57 UTC (rev 10254)
@@ -321,11 +321,8 @@
         match in this snippet.
     <system_message level="3" line="5" source="test data" type="ERROR">
         <paragraph>
-            Substitution definition contains illegal element <reference>:
+            Anonymous references are not supported in a substitution definition.
         <literal_block xml:space="preserve">
-            <reference anonymous="1" name="anonymous">
-                anonymous
-        <literal_block xml:space="preserve">
             .. |invalid| replace:: anonymous__
     <paragraph>
         <reference anonymous="1" name="hyperlink" refuri="URL">

Modified: trunk/docutils/test/test_transforms/test_substitutions.py
===================================================================
--- trunk/docutils/test/test_transforms/test_substitutions.py	2025-10-06 12:29:47 UTC (rev 10253)
+++ trunk/docutils/test/test_transforms/test_substitutions.py	2025-11-02 17:50:57 UTC (rev 10254)
@@ -25,6 +25,8 @@
 
 
 class TransformTestCase(unittest.TestCase):
+    maxDiff = None
+
     def test_transforms(self):
         parser = Parser()
         settings = get_default_settings(Parser)
@@ -378,11 +380,8 @@
         Substitution definition with an illegal element:
     <system_message level="3" line="3" source="test data" type="ERROR">
         <paragraph>
-            Substitution definition contains illegal element <target>:
+            Targets (names and identifiers) are not supported in a substitution definition.
         <literal_block xml:space="preserve">
-            <target ids="target" names="target">
-                target
-        <literal_block xml:space="preserve">
             .. |target| replace:: _`target`
     <paragraph>
         Make sure this substitution definition is not registered: \n\

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

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

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

Revision: 10253
          http://sourceforge.net/p/docutils/code/10253
Author:   milde
Date:     2025-10-06 12:29:47 +0000 (Mon, 06 Oct 2025)
Log Message:
-----------
Documentation update/fixes.

Describe intended behaviour and add cross-links to the related TODO list item
for possible future "footnotes" and "citation" directives.

Correct terms in "image" directive documentation.

Simple example for auto-nubered footnotes.

Modified Paths:
--------------
    trunk/docutils/docs/dev/todo.rst
    trunk/docutils/docs/ref/rst/directives.rst
    trunk/docutils/docs/ref/rst/restructuredtext.rst

Modified: trunk/docutils/docs/dev/todo.rst
===================================================================
--- trunk/docutils/docs/dev/todo.rst	2025-09-24 16:22:33 UTC (rev 10252)
+++ trunk/docutils/docs/dev/todo.rst	2025-10-06 12:29:47 UTC (rev 10253)
@@ -2030,7 +2030,7 @@
 
   Collect and move footnotes & citations to the end of a document or the
   place of a "footnotes" or "citations" directive
-  (see `<./ref/rst/directives.html>_`)
+  (see `<../ref/rst/directives.html#references>`_)
 
   Footnotes:
     Collect all footnotes that are referenced in the document before the

Modified: trunk/docutils/docs/ref/rst/directives.rst
===================================================================
--- trunk/docutils/docs/ref/rst/directives.rst	2025-09-24 16:22:33 UTC (rev 10252)
+++ trunk/docutils/docs/ref/rst/directives.rst	2025-10-06 12:29:47 UTC (rev 10253)
@@ -228,16 +228,17 @@
 
 A `URI reference`_ to the image source file is specified in the directive
 argument.  As with hyperlink targets, the image URI may begin on the
-same line as the explicit markup start and target name, or it may
+same line as the explicit markup start and directive name, or it may
 begin in an indented text block immediately following, with no
 intervening blank lines.  If there are multiple lines in the link
 block, they are stripped of leading and trailing whitespace and joined
 together.
 
-Optionally, the image link block may contain a flat field list, the
+Optionally, the image directive may contain a flat field list, the
 `image options`_.  For example::
 
-    .. image:: picture.jpeg
+    .. image::
+       https://example.com/images/picture.jpeg
        :height: 100px
        :width: 200 px
        :scale: 50 %
@@ -245,10 +246,9 @@
        :alt: alternate text
        :align: right
 
+`Inline images`_ can be defined with an "image" directive in a
+`substitution definition`_, e.g. ::
 
-*Inline images* can be defined with an "image" directive in a `substitution
-definition`_, e.g. ::
-
     |Red light| means stop, |green light| means go.
 
     .. |red light|    image:: red_light.png
@@ -277,6 +277,8 @@
     Alternate text: a short description of the image, displayed by
     applications that cannot display images, or spoken by applications
     for visually impaired users.
+    Defaults to the image URI or, in a `substitution definition`_ to the
+    substitution text.
 
 ``height`` : length_
     The desired height of the image.
@@ -1355,7 +1357,11 @@
 =========
 
 **NOT IMPLEMENTED YET**
+(`see todo item <../../dev/todo.html#footnote-citation-gathering>`_)
 
+Collect `footnotes <footnote_>`__ and move them to the place of this
+directive.
+
 .. class:: field-indent-13em
 
 :Directive Type: "footnotes"
@@ -1371,12 +1377,19 @@
 =========
 
 **NOT IMPLEMENTED YET**
+(`see todo item <../../dev/todo.html#footnote-citation-gathering>`_)
 
+Collect `citations <citation_>`__ or generate them for all
+`citation references`_ from a database [#]_ and move them
+to the place of this directive.
+
+.. [#] For example a BibTeX file (cf. the use_bibtex_ LaTeX writer setting).
+
 .. class:: field-indent-13em
 
 :Directive Type: "citations"
 :Doctree Elements: `\<pending>`_, `\<topic>`_
-:Directive Arguments: none?
+:Directive Arguments: optional (database)?
 :Directive Options: Possible?
 :Directive Content: none
 
@@ -1398,9 +1411,9 @@
  Directives for Substitution Definitions
 -----------------------------------------
 
-The directives introduced in this section may only be used in
+The directives introduced in this section may be used in
 `substitution definitions`_.  They may not be used directly,
-in standalone context.
+in standalone context (except for the image_ directive).
 
 .. _substitution definitions:
 .. _substitution definition: restructuredtext.html#substitution-definitions
@@ -2300,6 +2313,8 @@
 
 .. _reStructuredText Markup Specification: restructuredtext.html
 .. _block quote: restructuredtext.html#block-quotes
+.. _citation references: restructuredtext.html#citation-references
+.. _citation: restructuredtext.html#citations
 .. _comments: restructuredtext.html#comments
 .. _directives: restructuredtext.html#directives
 .. _document title: restructuredtext.html#document-title
@@ -2308,6 +2323,7 @@
 .. _external hyperlink target:
 .. _external hyperlink targets:
     restructuredtext.html#external-hyperlink-targets
+.. _footnote: restructuredtext.html#footnotes
 .. _grid table: restructuredtext.html#grid-tables
 .. _hyperlink reference:
 .. _hyperlink references: restructuredtext.html#hyperlink-references
@@ -2326,6 +2342,7 @@
 .. _"raw" role: roles.html#raw
 
 .. Docutils Configuration
+.. _use_bibtex: ../../user/config.html#use-bibtex
 .. _file_insertion_enabled: ../../user/config.html#file-insertion-enabled
 .. _generate_oowriter_toc: ../../user/config.html#generate-oowriter-toc
 .. _image_loading: ../../user/config.html#image-loading

Modified: trunk/docutils/docs/ref/rst/restructuredtext.rst
===================================================================
--- trunk/docutils/docs/ref/rst/restructuredtext.rst	2025-09-24 16:22:33 UTC (rev 10252)
+++ trunk/docutils/docs/ref/rst/restructuredtext.rst	2025-10-06 12:29:47 UTC (rev 10253)
@@ -1764,17 +1764,21 @@
 
 A number sign (``#``) may be used as the first character of a footnote
 label to request automatic numbering of the footnote or footnote
-reference.
+reference::
 
+    Footnotes may be auto-numbered. [#]_
+
+    .. [#] This is an auto-numbered footnote.
+
 The first footnote to request automatic numbering is assigned the
 label "1", the second is assigned the label "2", and so on (assuming
 there is no conflict with another reference name; see also
 `Mixed Manual and Auto-Numbered Footnotes`_ below).
-If the footnote label is a single ``#``, the assigned number is also used
-as reference name.
 
 .. _autonumber label:
 
+If the footnote label is a single ``#``, the assigned number is also used
+as reference name.
 A custom reference name can be specified appending a `simple reference
 name`_ to the number sign to form an *autonumber label*.
 For example::
@@ -2969,9 +2973,10 @@
 `footnote label`_ followed by a trailing underscore.
 For example::
 
-    Please RTFM [1]_.
+    Please RTFM [1]_. [#]_
 
     .. [1] Read The Fine Manual
+    .. [#] See "footnotes_" for the format of the *footnote label*.
 
 `Inline markup recognition rules`_ may require whitespace in front of the
 footnote reference. To remove the whitespace from the output, use an

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

[Docutils-checkins] SF.net SVN: docutils:[10252] trunk/sandbox/manpage-wr iter

[<gr...@us...>]

Revision: 10252
          http://sourceforge.net/p/docutils/code/10252
Author:   grubert
Date:     2025-09-24 16:22:33 +0000 (Wed, 24 Sep 2025)
Log Message:
-----------
version 0.22.3b1.dev

Modified Paths:
--------------
    trunk/sandbox/manpage-writer/expected/characters.man
    trunk/sandbox/manpage-writer/expected/compact_lists.man
    trunk/sandbox/manpage-writer/expected/docinfo-deu-l_de.man
    trunk/sandbox/manpage-writer/expected/docinfo-deu-l_en.man
    trunk/sandbox/manpage-writer/expected/docinfo-deu.man
    trunk/sandbox/manpage-writer/expected/docinfo-eng-l_de.man
    trunk/sandbox/manpage-writer/expected/docinfo-eng-l_en.man
    trunk/sandbox/manpage-writer/expected/docinfo-eng.man
    trunk/sandbox/manpage-writer/expected/dotted.man
    trunk/sandbox/manpage-writer/expected/indent.man
    trunk/sandbox/manpage-writer/expected/man-de.1.man
    trunk/sandbox/manpage-writer/expected/optionslisttest.man
    trunk/sandbox/manpage-writer/expected/optionstoo.man
    trunk/sandbox/manpage-writer/expected/quotes.man
    trunk/sandbox/manpage-writer/expected/ref-2025-urue.man
    trunk/sandbox/manpage-writer/expected/ref-2025.man
    trunk/sandbox/manpage-writer/expected/references.man
    trunk/sandbox/manpage-writer/expected/refs-urue.man
    trunk/sandbox/manpage-writer/expected/refs.man
    trunk/sandbox/manpage-writer/expected/test.man
    trunk/sandbox/manpage-writer/expected-mandoc/characters.man
    trunk/sandbox/manpage-writer/expected-mandoc/compact_lists.man
    trunk/sandbox/manpage-writer/expected-mandoc/docinfo-deu-l_de.man
    trunk/sandbox/manpage-writer/expected-mandoc/docinfo-deu-l_en.man
    trunk/sandbox/manpage-writer/expected-mandoc/docinfo-deu.man
    trunk/sandbox/manpage-writer/expected-mandoc/docinfo-eng-l_de.man
    trunk/sandbox/manpage-writer/expected-mandoc/docinfo-eng-l_en.man
    trunk/sandbox/manpage-writer/expected-mandoc/docinfo-eng.man
    trunk/sandbox/manpage-writer/expected-mandoc/dotted.man
    trunk/sandbox/manpage-writer/expected-mandoc/indent.man
    trunk/sandbox/manpage-writer/expected-mandoc/man-de.1.man
    trunk/sandbox/manpage-writer/expected-mandoc/optionslisttest.man
    trunk/sandbox/manpage-writer/expected-mandoc/optionstoo.man
    trunk/sandbox/manpage-writer/expected-mandoc/quotes.man
    trunk/sandbox/manpage-writer/expected-mandoc/references.man
    trunk/sandbox/manpage-writer/expected-mandoc/refs-urue.man
    trunk/sandbox/manpage-writer/expected-mandoc/test.man

Modified: trunk/sandbox/manpage-writer/expected/characters.man
===================================================================
--- trunk/sandbox/manpage-writer/expected/characters.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected/characters.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected/compact_lists.man
===================================================================
--- trunk/sandbox/manpage-writer/expected/compact_lists.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected/compact_lists.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected/docinfo-deu-l_de.man
===================================================================
--- trunk/sandbox/manpage-writer/expected/docinfo-deu-l_de.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected/docinfo-deu-l_de.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected/docinfo-deu-l_en.man
===================================================================
--- trunk/sandbox/manpage-writer/expected/docinfo-deu-l_en.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected/docinfo-deu-l_en.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected/docinfo-deu.man
===================================================================
--- trunk/sandbox/manpage-writer/expected/docinfo-deu.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected/docinfo-deu.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected/docinfo-eng-l_de.man
===================================================================
--- trunk/sandbox/manpage-writer/expected/docinfo-eng-l_de.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected/docinfo-eng-l_de.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected/docinfo-eng-l_en.man
===================================================================
--- trunk/sandbox/manpage-writer/expected/docinfo-eng-l_en.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected/docinfo-eng-l_en.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected/docinfo-eng.man
===================================================================
--- trunk/sandbox/manpage-writer/expected/docinfo-eng.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected/docinfo-eng.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected/dotted.man
===================================================================
--- trunk/sandbox/manpage-writer/expected/dotted.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected/dotted.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected/indent.man
===================================================================
--- trunk/sandbox/manpage-writer/expected/indent.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected/indent.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected/man-de.1.man
===================================================================
--- trunk/sandbox/manpage-writer/expected/man-de.1.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected/man-de.1.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,6 +1,6 @@
 '\" t
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected/optionslisttest.man
===================================================================
--- trunk/sandbox/manpage-writer/expected/optionslisttest.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected/optionslisttest.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected/optionstoo.man
===================================================================
--- trunk/sandbox/manpage-writer/expected/optionstoo.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected/optionstoo.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected/quotes.man
===================================================================
--- trunk/sandbox/manpage-writer/expected/quotes.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected/quotes.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected/ref-2025-urue.man
===================================================================
--- trunk/sandbox/manpage-writer/expected/ref-2025-urue.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected/ref-2025-urue.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected/ref-2025.man
===================================================================
--- trunk/sandbox/manpage-writer/expected/ref-2025.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected/ref-2025.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected/references.man
===================================================================
--- trunk/sandbox/manpage-writer/expected/references.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected/references.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected/refs-urue.man
===================================================================
--- trunk/sandbox/manpage-writer/expected/refs-urue.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected/refs-urue.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected/refs.man
===================================================================
--- trunk/sandbox/manpage-writer/expected/refs.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected/refs.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected/test.man
===================================================================
--- trunk/sandbox/manpage-writer/expected/test.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected/test.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,6 +1,6 @@
 '\" t
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected-mandoc/characters.man
===================================================================
--- trunk/sandbox/manpage-writer/expected-mandoc/characters.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected-mandoc/characters.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected-mandoc/compact_lists.man
===================================================================
--- trunk/sandbox/manpage-writer/expected-mandoc/compact_lists.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected-mandoc/compact_lists.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected-mandoc/docinfo-deu-l_de.man
===================================================================
--- trunk/sandbox/manpage-writer/expected-mandoc/docinfo-deu-l_de.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected-mandoc/docinfo-deu-l_de.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected-mandoc/docinfo-deu-l_en.man
===================================================================
--- trunk/sandbox/manpage-writer/expected-mandoc/docinfo-deu-l_en.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected-mandoc/docinfo-deu-l_en.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected-mandoc/docinfo-deu.man
===================================================================
--- trunk/sandbox/manpage-writer/expected-mandoc/docinfo-deu.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected-mandoc/docinfo-deu.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected-mandoc/docinfo-eng-l_de.man
===================================================================
--- trunk/sandbox/manpage-writer/expected-mandoc/docinfo-eng-l_de.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected-mandoc/docinfo-eng-l_de.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected-mandoc/docinfo-eng-l_en.man
===================================================================
--- trunk/sandbox/manpage-writer/expected-mandoc/docinfo-eng-l_en.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected-mandoc/docinfo-eng-l_en.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected-mandoc/docinfo-eng.man
===================================================================
--- trunk/sandbox/manpage-writer/expected-mandoc/docinfo-eng.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected-mandoc/docinfo-eng.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected-mandoc/dotted.man
===================================================================
--- trunk/sandbox/manpage-writer/expected-mandoc/dotted.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected-mandoc/dotted.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected-mandoc/indent.man
===================================================================
--- trunk/sandbox/manpage-writer/expected-mandoc/indent.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected-mandoc/indent.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected-mandoc/man-de.1.man
===================================================================
--- trunk/sandbox/manpage-writer/expected-mandoc/man-de.1.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected-mandoc/man-de.1.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,6 +1,6 @@
 '\" t
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected-mandoc/optionslisttest.man
===================================================================
--- trunk/sandbox/manpage-writer/expected-mandoc/optionslisttest.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected-mandoc/optionslisttest.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected-mandoc/optionstoo.man
===================================================================
--- trunk/sandbox/manpage-writer/expected-mandoc/optionstoo.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected-mandoc/optionstoo.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected-mandoc/quotes.man
===================================================================
--- trunk/sandbox/manpage-writer/expected-mandoc/quotes.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected-mandoc/quotes.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected-mandoc/references.man
===================================================================
--- trunk/sandbox/manpage-writer/expected-mandoc/references.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected-mandoc/references.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected-mandoc/refs-urue.man
===================================================================
--- trunk/sandbox/manpage-writer/expected-mandoc/refs-urue.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected-mandoc/refs-urue.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/sandbox/manpage-writer/expected-mandoc/test.man
===================================================================
--- trunk/sandbox/manpage-writer/expected-mandoc/test.man	2025-09-22 21:00:13 UTC (rev 10251)
+++ trunk/sandbox/manpage-writer/expected-mandoc/test.man	2025-09-24 16:22:33 UTC (rev 10252)
@@ -1,6 +1,6 @@
 '\" t
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2b1.dev manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

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

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

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

Revision: 10251
          http://sourceforge.net/p/docutils/code/10251
Author:   milde
Date:     2025-09-22 21:00:13 +0000 (Mon, 22 Sep 2025)
Log Message:
-----------
rST parser: allow for combining characters in grid tables.

Ignore combining characters when extracting a grid table block and
when parsing the grid table structure.
Allow for combining characters when extracting 2d-block with cell content.

Missing part of the fixes in [r7231].

Fixes [bugs:#128] and [bugs:#512].

Modified Paths:
--------------
    trunk/docutils/HISTORY.rst
    trunk/docutils/RELEASE-NOTES.rst
    trunk/docutils/docutils/parsers/rst/states.py
    trunk/docutils/docutils/parsers/rst/tableparser.py
    trunk/docutils/docutils/statemachine.py
    trunk/docutils/test/test_parsers/test_rst/test_TableParser.py

Modified: trunk/docutils/HISTORY.rst
===================================================================
--- trunk/docutils/HISTORY.rst	2025-09-22 20:59:57 UTC (rev 10250)
+++ trunk/docutils/HISTORY.rst	2025-09-22 21:00:13 UTC (rev 10251)
@@ -17,9 +17,19 @@
 Release 0.22.3b1.dev (unpublished)
 ==================================
 
-.
+* docutils/parsers/rst/states.py
 
+  - Ignore combining characters when extracting a grid table block
 
+* docutils/parsers/rst/tableparser.py
+
+  - Ignore combining characters when parsing the grid table structure.
+
+* docutils/statemachine.py
+
+  - Fix handling of combining characters when extracting 2d-block.
+
+
 Release 0.22.2 (2025-09-20)
 ===========================
 

Modified: trunk/docutils/RELEASE-NOTES.rst
===================================================================
--- trunk/docutils/RELEASE-NOTES.rst	2025-09-22 20:59:57 UTC (rev 10250)
+++ trunk/docutils/RELEASE-NOTES.rst	2025-09-22 21:00:13 UTC (rev 10251)
@@ -266,7 +266,9 @@
 Release 0.22.3b1.dev (unpublished)
 ==================================
 
-.
+Rst parser:
+  Allow for combining characters in grid tables.
+  Fixes bugs #128 and #512.
 
 
 Release 0.22.2 (2025-09-20)
@@ -278,19 +280,11 @@
 Release 0.22.1 (2025-09-17)
 ===========================
 
-* docutils/parsers/rst/states.py
-
+Rst parser:
   - Relax "section title" system messages from SEVERE to ERROR.
-  - Fix behaviour with nested parsing into a detached node
-    (cf. bugs #508 and #509).
-  - New attribute `NestedStateMachine.parent_state_machine`.
-    Use case: update the "current node" of parent state machine(s)
-    after nested parsing.
-  - Better error messages for grid table markup errors (bug #504),
-    based on patch #214 by Jynn Nelson.
+  - New attribute `parsers.rst.states.NestedStateMachine.parent_state_machine`.
 
-* docutils/writers/latex2e/__init__.py
-
+LaTeX writer:
   - Add cross-reference anchors (``\phantomsection\label{...}``)
     for elements with IDs (fixes bug #503).
   - Fix cross-reference anchor placement in figures, images,

Modified: trunk/docutils/docutils/parsers/rst/states.py
===================================================================
--- trunk/docutils/docutils/parsers/rst/states.py	2025-09-22 20:59:57 UTC (rev 10250)
+++ trunk/docutils/docutils/parsers/rst/states.py	2025-09-22 21:00:13 UTC (rev 10251)
@@ -116,7 +116,7 @@
 from docutils.nodes import unescape, whitespace_normalize_name
 import docutils.parsers.rst
 from docutils.parsers.rst import directives, languages, tableparser, roles
-from docutils.utils import escape2null, column_width
+from docutils.utils import escape2null, column_width, strip_combining_chars
 from docutils.utils import punctuation_chars, urischemes
 from docutils.utils import split_escaped_whitespace
 from docutils.utils._roman_numerals import (InvalidRomanNumeralError,
@@ -1848,7 +1848,8 @@
                 messages.extend(self.malformed_table(block, detail, i))
                 return [], messages, blank_finish
         for i in range(len(block)):     # check right edge
-            if len(block[i]) != width or block[i][-1] not in '+|':
+            if len(strip_combining_chars(block[i])
+                   ) != width or block[i][-1] not in '+|':
                 detail = 'Right border not aligned or missing.'
                 messages.extend(self.malformed_table(block, detail, i))
                 return [], messages, blank_finish

Modified: trunk/docutils/docutils/parsers/rst/tableparser.py
===================================================================
--- trunk/docutils/docutils/parsers/rst/tableparser.py	2025-09-22 20:59:57 UTC (rev 10250)
+++ trunk/docutils/docutils/parsers/rst/tableparser.py	2025-09-22 21:00:13 UTC (rev 10251)
@@ -167,6 +167,9 @@
         We'll end up knowing all the row and column boundaries, cell positions
         and their dimensions.
         """
+        # a copy of the block without combining characters:
+        self.stripped_block = [strip_combining_chars(line)
+                               for line in self.block]
         corners = [(0, 0)]
         while corners:
             top, left = corners.pop(0)
@@ -209,7 +212,7 @@
 
     def scan_cell(self, top, left):
         """Starting at the top-left corner, start tracing out a cell."""
-        assert self.block[top][left] == '+'
+        assert self.stripped_block[top][left] == '+'
         return self.scan_right(top, left)
 
     def scan_right(self, top, left):
@@ -218,7 +221,7 @@
         boundaries ('+').
         """
         colseps = {}
-        line = self.block[top]
+        line = self.stripped_block[top]
         for i in range(left + 1, self.right + 1):
             if line[i] == '+':
                 colseps[i] = [top]
@@ -238,7 +241,7 @@
         """
         rowseps = {}
         for i in range(top + 1, self.bottom + 1):
-            if self.block[i][right] == '+':
+            if self.stripped_block[i][right] == '+':
                 rowseps[i] = [right]
                 result = self.scan_left(top, left, i, right)
                 if result:
@@ -245,7 +248,7 @@
                     newrowseps, colseps = result
                     update_dict_of_lists(rowseps, newrowseps)
                     return i, rowseps, colseps
-            elif self.block[i][right] != '|':
+            elif self.stripped_block[i][right] != '|':
                 return None
         return None
 
@@ -255,7 +258,7 @@
         It must line up with the starting point.
         """
         colseps = {}
-        line = self.block[bottom]
+        line = self.stripped_block[bottom]
         for i in range(right - 1, left, -1):
             if line[i] == '+':
                 colseps[i] = [bottom]
@@ -275,9 +278,9 @@
         """
         rowseps = {}
         for i in range(bottom - 1, top, -1):
-            if self.block[i][left] == '+':
+            if self.stripped_block[i][left] == '+':
                 rowseps[i] = [left]
-            elif self.block[i][left] != '|':
+            elif self.stripped_block[i][left] != '|':
                 return None
         return rowseps
 

Modified: trunk/docutils/docutils/statemachine.py
===================================================================
--- trunk/docutils/docutils/statemachine.py	2025-09-22 20:59:57 UTC (rev 10250)
+++ trunk/docutils/docutils/statemachine.py	2025-09-22 21:00:13 UTC (rev 10251)
@@ -1426,18 +1426,18 @@
     def get_2D_block(self, top, left, bottom, right, strip_indent=True):
         block = self[top:bottom]
         indent = right
-        for i in range(len(block.data)):
-            # get slice from line, care for combining characters
-            ci = utils.column_indices(block.data[i])
+        for i, line in enumerate(block.data):
+            # trim line to block borders, allow for for combining characters
+            adjusted_indices = utils.column_indices(line)
             try:
-                left = ci[left]
+                left_i = adjusted_indices[left]
             except IndexError:
-                left += len(block.data[i]) - len(ci)
+                left_i = left
             try:
-                right = ci[right]
+                right_i = adjusted_indices[right]
             except IndexError:
-                right += len(block.data[i]) - len(ci)
-            block.data[i] = line = block.data[i][left:right].rstrip()
+                right_i = len(line)
+            block.data[i] = line = line[left_i:right_i].rstrip()
             if line:
                 indent = min(indent, len(line) - len(line.lstrip()))
         if strip_indent and 0 < indent < right:

Modified: trunk/docutils/test/test_parsers/test_rst/test_TableParser.py
===================================================================
--- trunk/docutils/test/test_parsers/test_rst/test_TableParser.py	2025-09-22 20:59:57 UTC (rev 10250)
+++ trunk/docutils/test/test_parsers/test_rst/test_TableParser.py	2025-09-22 21:00:13 UTC (rev 10251)
@@ -73,32 +73,32 @@
  [],
  [[(0, 0, 1, ['A table with']),
    (0, 0, 1, ['two columns.'])]])],
-# Combining chars in grid tables still fail
-# ["""\
-# +--------------+------------------+
-# | A tāble w̅ith | comb̲ining chars. |
-# +--------------+------------------+
-# """,
-# [(0, 0, 2, 15, ['A table with']),
-#  (0, 15, 2, 30, ['combining chars.'])],
-# ([14, 14],
-#  [],
-#  [[(0, 0, 1, ['A table with']),
-#    (0, 0, 1, ['combining chars.'])]])],
+# Combining chars in table cells
 ["""\
++--------------+------------------+
+| A tāble w̅ith | comb̲ining chars. |
++--------------+------------------+
+""",
+[(0, 0, 2, 15, ['A tāble w̅ith']),
+ (0, 15, 2, 34, ['comb̲ining chars.'])],
+([14, 18],
+ [],
+ [[(0, 0, 1, ['A tāble w̅ith']),
+   (0, 0, 1, ['comb̲ining chars.'])]])],
+["""\
 +--------------+-------------+
-| A table with | two columns |
+| A tāble w̅ith | two columns |
 +--------------+-------------+
 | and          | two rows.   |
 +--------------+-------------+
 """,
-[(0, 0, 2, 15, ['A table with']),
+[(0, 0, 2, 15, ['A tāble w̅ith']),
  (0, 15, 2, 29, ['two columns']),
  (2, 0, 4, 15, ['and']),
  (2, 15, 4, 29, ['two rows.'])],
 ([14, 13],
  [],
- [[(0, 0, 1, ['A table with']),
+ [[(0, 0, 1, ['A tāble w̅ith']),
    (0, 0, 1, ['two columns'])],
   [(0, 0, 3, ['and']),
    (0, 0, 3, ['two rows.'])]])],
@@ -126,18 +126,18 @@
    None]])],
 ["""\
 +------------+-------------+---------------+
-| A table    | two rows in | and row spans |
-| with three +-------------+ to left and   |
+| A tāble    | two rows in | and row spans |
+| with t̲h̲r̲e̲e̲ +-------------+ to left and   |
 | columns,   | the middle, | right.        |
 +------------+-------------+---------------+
 """,
-[(0, 0, 4, 13, ['A table', 'with three', 'columns,']),
+[(0, 0, 4, 13, ['A tāble', 'with t̲h̲r̲e̲e̲', 'columns,']),
  (0, 13, 2, 27, ['two rows in']),
  (0, 27, 4, 43, ['and row spans', 'to left and', 'right.']),
  (2, 13, 4, 27, ['the middle,'])],
 ([12, 13, 15],
  [],
- [[(1, 0, 1, ['A table', 'with three', 'columns,']),
+ [[(1, 0, 1, ['A tāble', 'with t̲h̲r̲e̲e̲', 'columns,']),
    (0, 0, 1, ['two rows in']),
    (1, 0, 1, ['and row spans', 'to left and', 'right.'])],
   [None,

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

[Docutils-checkins] SF.net SVN: docutils:[10250] trunk/docutils/docutils/ utils/__init__.py

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

Revision: 10250
          http://sourceforge.net/p/docutils/code/10250
Author:   milde
Date:     2025-09-22 20:59:57 +0000 (Mon, 22 Sep 2025)
Log Message:
-----------
Simplify `utils.column_indices()`.

Modified Paths:
--------------
    trunk/docutils/docutils/utils/__init__.py

Modified: trunk/docutils/docutils/utils/__init__.py
===================================================================
--- trunk/docutils/docutils/utils/__init__.py	2025-09-20 22:08:37 UTC (rev 10249)
+++ trunk/docutils/docutils/utils/__init__.py	2025-09-22 20:59:57 UTC (rev 10250)
@@ -704,10 +704,7 @@
     """
     # TODO: account for asian wide chars here instead of using dummy
     # replacements in the tableparser?
-    string_indices = list(range(len(text)))
-    for index in find_combining_chars(text):
-        string_indices[index] = None
-    return [i for i in string_indices if i is not None]
+    return [i for i, c in enumerate(text) if not unicodedata.combining(c)]
 
 
 east_asian_widths = {'W': 2,   # Wide

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

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

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

Revision: 10249
          http://sourceforge.net/p/docutils/code/10249
Author:   milde
Date:     2025-09-20 22:08:37 +0000 (Sat, 20 Sep 2025)
Log Message:
-----------
Documentation fixes.

Drop *rc1 release entries from HISTORY and RELEASE NOTES.
Add missing period.
Fix link target. Thanks to Dmitry Shachnev for reporting and patch #215.

Modified Paths:
--------------
    trunk/docutils/HISTORY.rst
    trunk/docutils/RELEASE-NOTES.rst
    trunk/docutils/docs/ref/rst/definitions.rst
    trunk/docutils/docs/ref/rst/roles.rst

Modified: trunk/docutils/HISTORY.rst
===================================================================
--- trunk/docutils/HISTORY.rst	2025-09-20 18:28:24 UTC (rev 10248)
+++ trunk/docutils/HISTORY.rst	2025-09-20 22:08:37 UTC (rev 10249)
@@ -23,21 +23,12 @@
 Release 0.22.2 (2025-09-20)
 ===========================
 
-CI of snakemake on an MacOS arm failed, because homebrew possibly restored
-a vim .swp-file ... maybe.
+Remove a spurious vim .swp-file to fix bug #513.
 
-So release without the .swp.
 
-
 Release 0.22.1 (2025-09-17)
 ===========================
 
-Only documentation fixes.
-
-
-Release 0.22.1rc1 (2025-09-13)
-==============================
-
 * docutils/frontend.py, docutils/writers/
 
   - More consistent and concise command line help.

Modified: trunk/docutils/RELEASE-NOTES.rst
===================================================================
--- trunk/docutils/RELEASE-NOTES.rst	2025-09-20 18:28:24 UTC (rev 10248)
+++ trunk/docutils/RELEASE-NOTES.rst	2025-09-20 22:08:37 UTC (rev 10249)
@@ -272,21 +272,12 @@
 Release 0.22.2 (2025-09-20)
 ===========================
 
-CI of snakemake on an MacOS arm failed, because homebrew possibly restored
-a vim .swp-file ... maybe.
+Remove a spurious vim .swp-file.
 
-So release without the .swp.
 
-
 Release 0.22.1 (2025-09-17)
 ===========================
 
-Only documentation fixes.
-
-
-Release 0.22.1rc1 (2025-09-13)
-==============================
-
 * docutils/parsers/rst/states.py
 
   - Relax "section title" system messages from SEVERE to ERROR.

Modified: trunk/docutils/docs/ref/rst/definitions.rst
===================================================================
--- trunk/docutils/docs/ref/rst/definitions.rst	2025-09-20 18:28:24 UTC (rev 10248)
+++ trunk/docutils/docs/ref/rst/definitions.rst	2025-09-20 22:08:37 UTC (rev 10249)
@@ -215,7 +215,7 @@
 .. [#attribute-optional] Would gain from support for attributes/arguments
    to inline roles (see TODO_).
 
-New in Docutils 0.22
+New in Docutils 0.22.
 
 .. _TODO: https://docutils.sourceforge.io/docs/dev/todo.html
           #acronym-and-abbreviation

Modified: trunk/docutils/docs/ref/rst/roles.rst
===================================================================
--- trunk/docutils/docs/ref/rst/roles.rst	2025-09-20 18:28:24 UTC (rev 10248)
+++ trunk/docutils/docs/ref/rst/roles.rst	2025-09-20 22:08:37 UTC (rev 10249)
@@ -400,7 +400,7 @@
 .. _hyperlink references: restructuredtext.html#hyperlink-references
 
 .. _reStructuredText Standard Definition Files: definitions.html
-.. _HTML5 inline markup elements: definitions.html#additional-roles-for-html
+.. _semantic inline markup: definitions.html#additional-roles-for-html
 .. _S5/HTML slide shows: definitions.html#s5-html-definitions
 
 .. _The Docutils Document Tree: ../doctree.html

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

[Docutils-checkins] SF.net SVN: docutils:[10248] trunk/sandbox/infrastructure/ releasing-log.rst

[<gr...@us...>]

Revision: 10248
          http://sourceforge.net/p/docutils/code/10248
Author:   grubert
Date:     2025-09-20 18:28:24 +0000 (Sat, 20 Sep 2025)
Log Message:
-----------
release 0.22.2

Modified Paths:
--------------
    trunk/sandbox/infrastructure/releasing-log.rst

Modified: trunk/sandbox/infrastructure/releasing-log.rst
===================================================================
--- trunk/sandbox/infrastructure/releasing-log.rst	2025-09-20 18:25:13 UTC (rev 10247)
+++ trunk/sandbox/infrastructure/releasing-log.rst	2025-09-20 18:28:24 UTC (rev 10248)
@@ -10,6 +10,81 @@
 Notes on what happend while releasing.
 
 
+Release 0.22.2 (2025-09-20)
+===========================
+
+CI of snakemake on an MacOS arm failed, because homebrew possibly restored
+a vim .swp-file ... maybe.
+
+So release without the .swp.
+
+* checkout current code
+* run: tox -epy313
+* set_version 0.22.2
+* run: tox -epy311
+* fix the version_info release to True
+* run: tox -epy39
+* Check README, HISTORY and RELEASE-NOTES titles.
+* check: svn di
+* svn commit 
+* check for swap files: ``find . -name \*.sw\*``
+* build wheel and tgz
+* test tgz and wheel locally
+* upload to pypi
+* test src.tgz from pypi, ignore missing HISTORY::
+
+    pip install --pre --no-binary docutils docutils
+
+* check for swap files in testenvironmen: ``find . -name \*.sw\*``
+* test wheel from pypi, ignore missing HISTORY.rst
+* update code in working directory
+* run tox : pass 39, 310, 311, 313, 314
+* tag #.# (Note: only directory docutils is copied)::
+
+    svn copy svn+ssh://grubert@svn.code.sf.net/p/docutils/code/trunk/docutils \
+             svn+ssh://grubert@svn.code.sf.net/p/docutils/code/tags/docutils-0.22.2 \
+             -m "tagging release 0.22.2"
+
+* check on sourceforge: https://sourceforge.net/p/docutils/code/HEAD/tree/tags/
+* update code in working directory
+* upload source and generated html to sf-htdocs/#.# ::
+
+    mkdir tmp1
+    cd tmp1
+    tar xzvf ../dist/docutils-0.22.2.tar.gz
+    cd docutils-0.22.2/
+    python3 tools/buildhtml.py .
+    find . -name \*.pyc -exec rm -v {} \;
+    find . -name __pycache__ -exec rmdir -v {} \;
+    rsync -e ssh -r -t ./ web.sourceforge.net:/home/project-web/docutils/htdocs/0.22.2
+
+* Check https://docutils.sourceforge.io/0.22.2/
+* Check web/index.rst for necessary corrections.
+* Run sandbox/infrastructure/docutils-update.local to update web-content.
+
+* Release to sourceforge.
+
+  - Upload docutils-0.22.2.tar.gz and release notes to sourceforge.
+  - Upload RELEASE_NOTES.rst as README.rst.
+  - Select docutils-0.22.2.tar.gz as default for all OS.
+
+* update working directory
+* set_version 0.22.3b1.dev
+* check docutils/__init__ ok
+* tox -epy39 310 312 313 pass
+* tox-epy311 fails 
+
+  somewhere still 0.22.2 but only via 3.11
+
+* docutils/HISTORY.rst: add title "Release 0.22.3b1.dev (unpublished)"
+* docutils/RELEASE-NOTES.rst: add title "Release 0.22.3b1.dev (unpublished)"
+* Check README, HISTORY and RELEASE-NOTES titles.
+* svn di
+* commit
+* now tox -epy311 passes
+* run: sandbox/infrastructure/docutils-update.local
+
+
 Release 0.22.1 (2025-09-17)
 ===========================
 
@@ -35,8 +110,8 @@
 * tag #.# (Note: only directory docutils is copied)::
 
     svn copy svn+ssh://grubert@svn.code.sf.net/p/docutils/code/trunk/docutils \
-             svn+ssh://grubert@svn.code.sf.net/p/docutils/code/tags/docutils-0.22 \
-             -m "tagging release 0.22"
+             svn+ssh://grubert@svn.code.sf.net/p/docutils/code/tags/docutils-0.22.1 \
+             -m "tagging release 0.22.1"
 
 * check on sourceforge: https://sourceforge.net/p/docutils/code/HEAD/tree/tags/
 * update code in working directory
@@ -77,7 +152,7 @@
         )
 
 * run: tox -epy312
-* docutils/HISTORY.rst: add title "Release 0.2.22b1.dev (unpublished)"
+* docutils/HISTORY.rst: add title "Release 0.22.2b1.dev (unpublished)"
 * docutils/RELEASE-NOTES.rst: add title "Release 0.22.2b1.dev (unpublished)"
 * Check README, HISTORY and RELEASE-NOTES titles.
 * svn di

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

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

[<gr...@us...>]

Revision: 10247
          http://sourceforge.net/p/docutils/code/10247
Author:   grubert
Date:     2025-09-20 18:25:13 +0000 (Sat, 20 Sep 2025)
Log Message:
-----------
version 0.22.3b1.dev

Modified Paths:
--------------
    trunk/docutils/HISTORY.rst
    trunk/docutils/README.rst
    trunk/docutils/RELEASE-NOTES.rst
    trunk/docutils/docutils/__init__.py
    trunk/docutils/test/functional/expected/buggy_mathml.html
    trunk/docutils/test/functional/expected/buggy_mathml_blahtexml.html
    trunk/docutils/test/functional/expected/buggy_mathml_pandoc.html
    trunk/docutils/test/functional/expected/buggy_mathml_ttm.html
    trunk/docutils/test/functional/expected/compact_lists.html
    trunk/docutils/test/functional/expected/dangerous.html
    trunk/docutils/test/functional/expected/field_name_limit.html
    trunk/docutils/test/functional/expected/footnotes_html5.html
    trunk/docutils/test/functional/expected/length_units_html5.html
    trunk/docutils/test/functional/expected/math_experiments_mathml.html
    trunk/docutils/test/functional/expected/math_experiments_mathml_blahtexml.html
    trunk/docutils/test/functional/expected/math_experiments_mathml_pandoc.html
    trunk/docutils/test/functional/expected/math_experiments_mathml_ttm.html
    trunk/docutils/test/functional/expected/math_output_html.html
    trunk/docutils/test/functional/expected/math_output_latex.html
    trunk/docutils/test/functional/expected/math_output_mathjax.html
    trunk/docutils/test/functional/expected/math_output_mathml.html
    trunk/docutils/test/functional/expected/mathematics_mathml.html
    trunk/docutils/test/functional/expected/mathematics_mathml_blahtexml.html
    trunk/docutils/test/functional/expected/mathematics_mathml_pandoc.html
    trunk/docutils/test/functional/expected/mathematics_mathml_ttm.html
    trunk/docutils/test/functional/expected/misc_rst_html4css1.html
    trunk/docutils/test/functional/expected/misc_rst_html5.html
    trunk/docutils/test/functional/expected/pep_html.html
    trunk/docutils/test/functional/expected/rst_html5_tuftig.html
    trunk/docutils/test/functional/expected/standalone_rst_docutils_xml.xml
    trunk/docutils/test/functional/expected/standalone_rst_html4css1.html
    trunk/docutils/test/functional/expected/standalone_rst_html5.html
    trunk/docutils/test/functional/expected/standalone_rst_manpage.man
    trunk/docutils/test/functional/expected/standalone_rst_s5_html_1.html
    trunk/docutils/test/functional/expected/standalone_rst_s5_html_2.html
    trunk/docutils/test/test_writers/test_manpage.py

Modified: trunk/docutils/HISTORY.rst
===================================================================
--- trunk/docutils/HISTORY.rst	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/HISTORY.rst	2025-09-20 18:25:13 UTC (rev 10247)
@@ -14,6 +14,12 @@
 .. contents::
 
 
+Release 0.22.3b1.dev (unpublished)
+==================================
+
+.
+
+
 Release 0.22.2 (2025-09-20)
 ===========================
 

Modified: trunk/docutils/README.rst
===================================================================
--- trunk/docutils/README.rst	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/README.rst	2025-09-20 18:25:13 UTC (rev 10247)
@@ -1,6 +1,6 @@
-=========================
- README: Docutils 0.22.2
-=========================
+===============================
+ README: Docutils 0.22.3b1.dev
+===============================
 
 :Author: David Goodger
 :Contact: go...@py...

Modified: trunk/docutils/RELEASE-NOTES.rst
===================================================================
--- trunk/docutils/RELEASE-NOTES.rst	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/RELEASE-NOTES.rst	2025-09-20 18:25:13 UTC (rev 10247)
@@ -263,6 +263,12 @@
    __ https://packages.debian.org/source/trixie/python-docutils
 
 
+Release 0.22.3b1.dev (unpublished)
+==================================
+
+.
+
+
 Release 0.22.2 (2025-09-20)
 ===========================
 

Modified: trunk/docutils/docutils/__init__.py
===================================================================
--- trunk/docutils/docutils/__init__.py	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/docutils/__init__.py	2025-09-20 18:25:13 UTC (rev 10247)
@@ -85,7 +85,7 @@
 
 __docformat__ = 'reStructuredText'
 
-__version__ = '0.22.2'
+__version__ = '0.22.3b1.dev'
 """Docutils version identifier (complies with PEP 440)::
 
     major.minor[.micro][releaselevel[serial]][.dev]
@@ -159,10 +159,10 @@
 __version_info__ = VersionInfo(
     major=0,
     minor=22,
-    micro=2,
-    releaselevel='final',  # one of 'alpha', 'beta', 'candidate', 'final'
-    serial=0,  # pre-release number (0 for final releases and snapshots)
-    release=True  # True for official releases and pre-releases
+    micro=3,
+    releaselevel='beta',  # one of 'alpha', 'beta', 'candidate', 'final'
+    serial=1,  # pre-release number (0 for final releases and snapshots)
+    release=False  # True for official releases and pre-releases
     )
 """Comprehensive version information tuple.
 

Modified: trunk/docutils/test/functional/expected/buggy_mathml.html
===================================================================
--- trunk/docutils/test/functional/expected/buggy_mathml.html	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/test/functional/expected/buggy_mathml.html	2025-09-20 18:25:13 UTC (rev 10247)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.2: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>buggy-maths</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/buggy_mathml_blahtexml.html
===================================================================
--- trunk/docutils/test/functional/expected/buggy_mathml_blahtexml.html	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/test/functional/expected/buggy_mathml_blahtexml.html	2025-09-20 18:25:13 UTC (rev 10247)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.2: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>buggy-maths</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/buggy_mathml_pandoc.html
===================================================================
--- trunk/docutils/test/functional/expected/buggy_mathml_pandoc.html	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/test/functional/expected/buggy_mathml_pandoc.html	2025-09-20 18:25:13 UTC (rev 10247)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.2: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>buggy-maths</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/buggy_mathml_ttm.html
===================================================================
--- trunk/docutils/test/functional/expected/buggy_mathml_ttm.html	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/test/functional/expected/buggy_mathml_ttm.html	2025-09-20 18:25:13 UTC (rev 10247)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.2: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>buggy-maths</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/compact_lists.html
===================================================================
--- trunk/docutils/test/functional/expected/compact_lists.html	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/test/functional/expected/compact_lists.html	2025-09-20 18:25:13 UTC (rev 10247)
@@ -3,7 +3,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta name="generator" content="Docutils 0.22.2: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
 <title>compact_lists.rst</title>
 <link rel="stylesheet" href="../input/data/html4css1.css" type="text/css" />
 </head>

Modified: trunk/docutils/test/functional/expected/dangerous.html
===================================================================
--- trunk/docutils/test/functional/expected/dangerous.html	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/test/functional/expected/dangerous.html	2025-09-20 18:25:13 UTC (rev 10247)
@@ -3,7 +3,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta name="generator" content="Docutils 0.22.2: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
 <title>dangerous.rst</title>
 <link rel="stylesheet" href="../input/data/html4css1.css" type="text/css" />
 </head>

Modified: trunk/docutils/test/functional/expected/field_name_limit.html
===================================================================
--- trunk/docutils/test/functional/expected/field_name_limit.html	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/test/functional/expected/field_name_limit.html	2025-09-20 18:25:13 UTC (rev 10247)
@@ -3,7 +3,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta name="generator" content="Docutils 0.22.2: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
 <title>field_list.rst</title>
 <link rel="stylesheet" href="../input/data/html4css1.css" type="text/css" />
 </head>

Modified: trunk/docutils/test/functional/expected/footnotes_html5.html
===================================================================
--- trunk/docutils/test/functional/expected/footnotes_html5.html	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/test/functional/expected/footnotes_html5.html	2025-09-20 18:25:13 UTC (rev 10247)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.2: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>Test footnote and citation rendering</title>
 <link rel="stylesheet" href="../input/data/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/length_units_html5.html
===================================================================
--- trunk/docutils/test/functional/expected/length_units_html5.html	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/test/functional/expected/length_units_html5.html	2025-09-20 18:25:13 UTC (rev 10247)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.2: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>Test length specifications</title>
 <link rel="stylesheet" href="../input/data/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/math_experiments_mathml.html
===================================================================
--- trunk/docutils/test/functional/expected/math_experiments_mathml.html	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/test/functional/expected/math_experiments_mathml.html	2025-09-20 18:25:13 UTC (rev 10247)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.2: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>Math Conversion Tests</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/math_experiments_mathml_blahtexml.html
===================================================================
--- trunk/docutils/test/functional/expected/math_experiments_mathml_blahtexml.html	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/test/functional/expected/math_experiments_mathml_blahtexml.html	2025-09-20 18:25:13 UTC (rev 10247)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.2: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>Math Conversion Tests</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/math_experiments_mathml_pandoc.html
===================================================================
--- trunk/docutils/test/functional/expected/math_experiments_mathml_pandoc.html	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/test/functional/expected/math_experiments_mathml_pandoc.html	2025-09-20 18:25:13 UTC (rev 10247)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.2: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>Math Conversion Tests</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/math_experiments_mathml_ttm.html
===================================================================
--- trunk/docutils/test/functional/expected/math_experiments_mathml_ttm.html	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/test/functional/expected/math_experiments_mathml_ttm.html	2025-09-20 18:25:13 UTC (rev 10247)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.2: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>Math Conversion Tests</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/math_output_html.html
===================================================================
--- trunk/docutils/test/functional/expected/math_output_html.html	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/test/functional/expected/math_output_html.html	2025-09-20 18:25:13 UTC (rev 10247)
@@ -3,7 +3,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta name="generator" content="Docutils 0.22.2: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
 <title>Mathematics</title>
 <link rel="stylesheet" href="../input/data/html4css1.css" type="text/css" />
 <link rel="stylesheet" href="../input/data/math.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/math_output_latex.html
===================================================================
--- trunk/docutils/test/functional/expected/math_output_latex.html	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/test/functional/expected/math_output_latex.html	2025-09-20 18:25:13 UTC (rev 10247)
@@ -3,7 +3,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta name="generator" content="Docutils 0.22.2: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
 <title>Mathematics</title>
 <link rel="stylesheet" href="../input/data/html4css1.css" type="text/css" />
 </head>

Modified: trunk/docutils/test/functional/expected/math_output_mathjax.html
===================================================================
--- trunk/docutils/test/functional/expected/math_output_mathjax.html	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/test/functional/expected/math_output_mathjax.html	2025-09-20 18:25:13 UTC (rev 10247)
@@ -3,7 +3,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta name="generator" content="Docutils 0.22.2: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
 <title>Mathematics</title>
 <script type="text/javascript" src="/usr/share/javascript/mathjax/MathJax.js?config=TeX-AMS_CHTML"></script>
 <link rel="stylesheet" href="../input/data/html4css1.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/math_output_mathml.html
===================================================================
--- trunk/docutils/test/functional/expected/math_output_mathml.html	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/test/functional/expected/math_output_mathml.html	2025-09-20 18:25:13 UTC (rev 10247)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.2: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>Mathematics</title>
 <link rel="stylesheet" href="../input/data/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/mathematics_mathml.html
===================================================================
--- trunk/docutils/test/functional/expected/mathematics_mathml.html	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/test/functional/expected/mathematics_mathml.html	2025-09-20 18:25:13 UTC (rev 10247)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.2: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>LaTeX syntax for mathematics</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/mathematics_mathml_blahtexml.html
===================================================================
--- trunk/docutils/test/functional/expected/mathematics_mathml_blahtexml.html	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/test/functional/expected/mathematics_mathml_blahtexml.html	2025-09-20 18:25:13 UTC (rev 10247)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.2: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>LaTeX syntax for mathematics</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/mathematics_mathml_pandoc.html
===================================================================
--- trunk/docutils/test/functional/expected/mathematics_mathml_pandoc.html	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/test/functional/expected/mathematics_mathml_pandoc.html	2025-09-20 18:25:13 UTC (rev 10247)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.2: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>LaTeX syntax for mathematics</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/mathematics_mathml_ttm.html
===================================================================
--- trunk/docutils/test/functional/expected/mathematics_mathml_ttm.html	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/test/functional/expected/mathematics_mathml_ttm.html	2025-09-20 18:25:13 UTC (rev 10247)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.2: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>LaTeX syntax for mathematics</title>
 <link rel="stylesheet" href="../../../docutils/writers/html5_polyglot/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/misc_rst_html4css1.html
===================================================================
--- trunk/docutils/test/functional/expected/misc_rst_html4css1.html	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/test/functional/expected/misc_rst_html4css1.html	2025-09-20 18:25:13 UTC (rev 10247)
@@ -3,7 +3,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta name="generator" content="Docutils 0.22.2: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
 <title>Additional tests with html4css1</title>
 <link rel="stylesheet" href="foo&amp;bar.css" type="text/css" />
 <link rel="stylesheet" href="../input/data/html4css1.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/misc_rst_html5.html
===================================================================
--- trunk/docutils/test/functional/expected/misc_rst_html5.html	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/test/functional/expected/misc_rst_html5.html	2025-09-20 18:25:13 UTC (rev 10247)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.2: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>Additional tests with HTML 5</title>
 <link rel="stylesheet" href="../input/data/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/pep_html.html
===================================================================
--- trunk/docutils/test/functional/expected/pep_html.html	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/test/functional/expected/pep_html.html	2025-09-20 18:25:13 UTC (rev 10247)
@@ -8,7 +8,7 @@
 -->
 <head>
   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-  <meta name="generator" content="Docutils 0.22.2: https://docutils.sourceforge.io/" />
+  <meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
   <title>PEP 100 - Test PEP</title>
   <link rel="stylesheet" href="../input/data/html4css1.css" type="text/css" />
 </head>

Modified: trunk/docutils/test/functional/expected/rst_html5_tuftig.html
===================================================================
--- trunk/docutils/test/functional/expected/rst_html5_tuftig.html	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/test/functional/expected/rst_html5_tuftig.html	2025-09-20 18:25:13 UTC (rev 10247)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.2: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>Special Features of the tuftig.css Stylesheet</title>
 <link rel="stylesheet" href="../input/data/minimal.css" type="text/css" />

Modified: trunk/docutils/test/functional/expected/standalone_rst_docutils_xml.xml
===================================================================
--- trunk/docutils/test/functional/expected/standalone_rst_docutils_xml.xml	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/test/functional/expected/standalone_rst_docutils_xml.xml	2025-09-20 18:25:13 UTC (rev 10247)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!DOCTYPE document PUBLIC "+//IDN docutils.sourceforge.net//DTD Docutils Generic//EN//XML" "http://docutils.sourceforge.net/docs/ref/docutils.dtd">
-<!-- Generated by Docutils 0.22.2 -->
+<!-- Generated by Docutils 0.22.3b1.dev -->
 <document ids="restructuredtext-test-document doctitle" names="restructuredtext\ test\ document doctitle" source="functional/input/standalone_rst_docutils_xml.rst" title="reStructuredText Test Document">
     <title>reStructuredText Test Document</title>
     <subtitle ids="examples-of-syntax-constructs subtitle" names="examples\ of\ syntax\ constructs subtitle">Examples of Syntax Constructs</subtitle>

Modified: trunk/docutils/test/functional/expected/standalone_rst_html4css1.html
===================================================================
--- trunk/docutils/test/functional/expected/standalone_rst_html4css1.html	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/test/functional/expected/standalone_rst_html4css1.html	2025-09-20 18:25:13 UTC (rev 10247)
@@ -3,7 +3,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta name="generator" content="Docutils 0.22.2: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
 <meta content="reStructuredText, test, parser" name="keywords" />
 <meta content="A test document, containing at least one example of each reStructuredText construct." lang="en" name="description" />
 <meta name="author" content="David Goodger" />

Modified: trunk/docutils/test/functional/expected/standalone_rst_html5.html
===================================================================
--- trunk/docutils/test/functional/expected/standalone_rst_html5.html	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/test/functional/expected/standalone_rst_html5.html	2025-09-20 18:25:13 UTC (rev 10247)
@@ -2,7 +2,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta charset="utf-8" />
-<meta name="generator" content="Docutils 0.22.2: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <meta content="reStructuredText, test, parser" name="keywords" />
 <meta content="A test document, containing at least one example of each reStructuredText construct." lang="en" name="description" xml:lang="en" />

Modified: trunk/docutils/test/functional/expected/standalone_rst_manpage.man
===================================================================
--- trunk/docutils/test/functional/expected/standalone_rst_manpage.man	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/test/functional/expected/standalone_rst_manpage.man	2025-09-20 18:25:13 UTC (rev 10247)
@@ -1,5 +1,5 @@
 .\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2 manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 .
 .nr rst2man-indent-level 0

Modified: trunk/docutils/test/functional/expected/standalone_rst_s5_html_1.html
===================================================================
--- trunk/docutils/test/functional/expected/standalone_rst_s5_html_1.html	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/test/functional/expected/standalone_rst_s5_html_1.html	2025-09-20 18:25:13 UTC (rev 10247)
@@ -3,7 +3,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta name="generator" content="Docutils 0.22.2: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
 <meta name="version" content="S5 1.1" />
 <meta name="author" content="David Goodger" />
 <meta name="date" content="2005-11-28" />

Modified: trunk/docutils/test/functional/expected/standalone_rst_s5_html_2.html
===================================================================
--- trunk/docutils/test/functional/expected/standalone_rst_s5_html_2.html	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/test/functional/expected/standalone_rst_s5_html_2.html	2025-09-20 18:25:13 UTC (rev 10247)
@@ -3,7 +3,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta name="generator" content="Docutils 0.22.2: https://docutils.sourceforge.io/" />
+<meta name="generator" content="Docutils 0.22.3b1.dev: https://docutils.sourceforge.io/" />
 <meta name="version" content="S5 1.1" />
 <meta name="author" content="David Goodger" />
 <meta name="date" content="2005-11-28" />

Modified: trunk/docutils/test/test_writers/test_manpage.py
===================================================================
--- trunk/docutils/test/test_writers/test_manpage.py	2025-09-20 18:05:03 UTC (rev 10246)
+++ trunk/docutils/test/test_writers/test_manpage.py	2025-09-20 18:25:13 UTC (rev 10247)
@@ -96,7 +96,7 @@
 
 
 document_start = r""".\" Man page generated from reStructuredText
-.\" by the Docutils 0.22.2 manpage writer.
+.\" by the Docutils 0.22.3b1.dev manpage writer.
 .
 """
 

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

[Docutils-checkins] SF.net SVN: docutils:[10246] tags/docutils-0.22.2 /

[<gr...@us...>]

Revision: 10246
          http://sourceforge.net/p/docutils/code/10246
Author:   grubert
Date:     2025-09-20 18:05:03 +0000 (Sat, 20 Sep 2025)
Log Message:
-----------
tagging release 0.22.2

Added Paths:
-----------
    tags/docutils-0.22.2/

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