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

milde--- via Docutils-checkins <[email protected]> Tue, 20 May 2025 15:48:29 +0000
Newsgroups gmane.text.docutils.cvs
Message-ID <[email protected]>
Revision: 10136
          http://sourceforge.net/p/docutils/code/10136
Author:   milde
Date:     2025-05-20 15:48:27 +0000 (Tue, 20 May 2025)
Log Message:
-----------
Minor edits.

Formatting.
Delayed annotations (from __future__).
Documentation.

Modified Paths:
--------------
    trunk/docutils/docs/ref/rst/directives.rst
    trunk/docutils/docutils/__main__.py
    trunk/docutils/docutils/nodes.py
    trunk/docutils/docutils/parsers/docutils_xml.py
    trunk/docutils/docutils/parsers/null.py
    trunk/docutils/docutils/parsers/recommonmark_wrapper.py
    trunk/docutils/docutils/parsers/rst/__init__.py
    trunk/docutils/docutils/parsers/rst/directives/tables.py
    trunk/docutils/docutils/parsers/rst/roles.py
    trunk/docutils/docutils/parsers/rst/states.py
    trunk/docutils/docutils/parsers/rst/tableparser.py
    trunk/docutils/docutils/readers/doctree.py
    trunk/docutils/docutils/readers/pep.py
    trunk/docutils/docutils/statemachine.py
    trunk/docutils/docutils/transforms/__init__.py
    trunk/docutils/docutils/transforms/components.py
    trunk/docutils/docutils/transforms/frontmatter.py
    trunk/docutils/docutils/transforms/misc.py
    trunk/docutils/docutils/transforms/parts.py
    trunk/docutils/docutils/transforms/peps.py
    trunk/docutils/docutils/transforms/references.py
    trunk/docutils/docutils/transforms/universal.py
    trunk/docutils/docutils/transforms/writer_aux.py
    trunk/docutils/docutils/utils/code_analyzer.py
    trunk/docutils/docutils/utils/math/__init__.py
    trunk/docutils/docutils/utils/math/math2html.py
    trunk/docutils/docutils/utils/math/mathml_elements.py
    trunk/docutils/docutils/utils/math/tex2mathml_extern.py
    trunk/docutils/docutils/utils/smartquotes.py
    trunk/docutils/docutils/writers/docutils_xml.py
    trunk/docutils/docutils/writers/html4css1/__init__.py
    trunk/docutils/docutils/writers/html5_polyglot/__init__.py
    trunk/docutils/docutils/writers/manpage.py
    trunk/docutils/docutils/writers/null.py
    trunk/docutils/docutils/writers/odf_odt/__init__.py
    trunk/docutils/docutils/writers/odf_odt/prepstyles.py
    trunk/docutils/docutils/writers/odf_odt/pygmentsformatter.py
    trunk/docutils/docutils/writers/pep_html/__init__.py
    trunk/docutils/docutils/writers/pseudoxml.py
    trunk/docutils/docutils/writers/s5_html/__init__.py
    trunk/docutils/docutils/writers/xetex/__init__.py

Modified: trunk/docutils/docs/ref/rst/directives.rst
===================================================================
--- trunk/docutils/docs/ref/rst/directives.rst	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docs/ref/rst/directives.rst	2025-05-20 15:48:27 UTC (rev 10136)
@@ -1983,7 +1983,7 @@
 
     Only recognized with the `"raw" <"raw" role_>`__ base role.
 
-_`language` : text
+_`language` : text_ (formal language)
     Name of a formal language, passed to Pygments_ for syntax highlighting.
     See `supported languages and markup formats`_ for recognized values.
 

Modified: trunk/docutils/docutils/__main__.py
===================================================================
--- trunk/docutils/docutils/__main__.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/__main__.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -18,6 +18,10 @@
 https://docs.python.org/3/library/__main__.html#main-py-in-python-packages
 """
 
+from __future__ import annotations
+
+__docformat__ = 'reStructuredText'
+
 import argparse
 import locale
 import sys

Modified: trunk/docutils/docutils/nodes.py
===================================================================
--- trunk/docutils/docutils/nodes.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/nodes.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -806,11 +806,7 @@
     def remove(self, item) -> None:
         self.children.remove(item)
 
-    def index(self,
-              item,
-              start: int = 0,
-              stop: int = sys.maxsize,
-              ) -> int:
+    def index(self, item, start: int = 0, stop: int = sys.maxsize) -> int:
         return self.children.index(item, start, stop)
 
     def previous_sibling(self):

Modified: trunk/docutils/docutils/parsers/docutils_xml.py
===================================================================
--- trunk/docutils/docutils/parsers/docutils_xml.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/parsers/docutils_xml.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -20,6 +20,10 @@
      in any Docutils release without prior notice.
 """
 
+from __future__ import annotations
+
+__docformat__ = 'reStructuredText'
+
 import re
 import xml.etree.ElementTree as ET
 

Modified: trunk/docutils/docutils/parsers/null.py
===================================================================
--- trunk/docutils/docutils/parsers/null.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/parsers/null.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -4,6 +4,10 @@
 
 """A do-nothing parser."""
 
+from __future__ import annotations
+
+__docformat__ = 'reStructuredText'
+
 from docutils import parsers
 
 

Modified: trunk/docutils/docutils/parsers/recommonmark_wrapper.py
===================================================================
--- trunk/docutils/docutils/parsers/recommonmark_wrapper.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/parsers/recommonmark_wrapper.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -24,6 +24,10 @@
    * The API is not settled and may change with any minor Docutils version.
 """
 
+from __future__ import annotations
+
+__docformat__ = 'reStructuredText'
+
 from docutils import Component
 from docutils import nodes
 

Modified: trunk/docutils/docutils/parsers/rst/__init__.py
===================================================================
--- trunk/docutils/docutils/parsers/rst/__init__.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/parsers/rst/__init__.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -67,9 +67,10 @@
 appropriate).
 """
 
+from __future__ import annotations
+
 __docformat__ = 'reStructuredText'
 
-
 import docutils.parsers
 import docutils.statemachine
 from docutils.parsers.rst import roles, states

Modified: trunk/docutils/docutils/parsers/rst/directives/tables.py
===================================================================
--- trunk/docutils/docutils/parsers/rst/directives/tables.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/parsers/rst/directives/tables.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -6,9 +6,10 @@
 Directives for table elements.
 """
 
+from __future__ import annotations
+
 __docformat__ = 'reStructuredText'
 
-
 import csv
 from urllib.request import urlopen
 from urllib.error import URLError

Modified: trunk/docutils/docutils/parsers/rst/roles.py
===================================================================
--- trunk/docutils/docutils/parsers/rst/roles.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/parsers/rst/roles.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -74,6 +74,8 @@
   immediately after the end of the current inline block (can also be empty).
 """
 
+from __future__ import annotations
+
 __docformat__ = 'reStructuredText'
 
 import warnings

Modified: trunk/docutils/docutils/parsers/rst/states.py
===================================================================
--- trunk/docutils/docutils/parsers/rst/states.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/parsers/rst/states.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -100,9 +100,10 @@
         continues with step 1.
 """
 
+from __future__ import annotations
+
 __docformat__ = 'reStructuredText'
 
-
 import re
 from types import FunctionType, MethodType
 from types import SimpleNamespace as Struct
@@ -117,10 +118,8 @@
 from docutils.utils import escape2null, column_width
 from docutils.utils import punctuation_chars, urischemes
 from docutils.utils import split_escaped_whitespace
-from docutils.utils._roman_numerals import (
-    InvalidRomanNumeralError,
-    RomanNumeral,
-)
+from docutils.utils._roman_numerals import (InvalidRomanNumeralError,
+                                            RomanNumeral)
 
 
 class MarkupError(DataError): pass

Modified: trunk/docutils/docutils/parsers/rst/tableparser.py
===================================================================
--- trunk/docutils/docutils/parsers/rst/tableparser.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/parsers/rst/tableparser.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -17,9 +17,10 @@
     `update_dict_of_lists()`: Merge two dictionaries containing list values.
 """
 
+from __future__ import annotations
+
 __docformat__ = 'reStructuredText'
 
-
 import re
 import sys
 from docutils import DataError

Modified: trunk/docutils/docutils/readers/doctree.py
===================================================================
--- trunk/docutils/docutils/readers/doctree.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/readers/doctree.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -4,6 +4,10 @@
 
 """Reader for existing document trees."""
 
+from __future__ import annotations
+
+__docformat__ = 'reStructuredText'
+
 from docutils import readers, utils, transforms
 
 

Modified: trunk/docutils/docutils/readers/pep.py
===================================================================
--- trunk/docutils/docutils/readers/pep.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/readers/pep.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -6,6 +6,8 @@
 Python Enhancement Proposal (PEP) Reader.
 """
 
+from __future__ import annotations
+
 __docformat__ = 'reStructuredText'
 
 from docutils.readers import standalone

Modified: trunk/docutils/docutils/statemachine.py
===================================================================
--- trunk/docutils/docutils/statemachine.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/statemachine.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -105,6 +105,8 @@
        sm.unlink()
 """
 
+from __future__ import annotations
+
 __docformat__ = 'restructuredtext'
 
 import sys

Modified: trunk/docutils/docutils/transforms/__init__.py
===================================================================
--- trunk/docutils/docutils/transforms/__init__.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/transforms/__init__.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -21,9 +21,10 @@
 choose to perform on the parsed document.
 """
 
+from __future__ import annotations
+
 __docformat__ = 'reStructuredText'
 
-
 from docutils import languages, ApplicationError, TransformSpec
 
 

Modified: trunk/docutils/docutils/transforms/components.py
===================================================================
--- trunk/docutils/docutils/transforms/components.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/transforms/components.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -6,11 +6,13 @@
 Docutils component-related transforms.
 """
 
-from docutils.transforms import Transform
+from __future__ import annotations
 
 __docformat__ = 'reStructuredText'
 
+from docutils.transforms import Transform
 
+
 class Filter(Transform):
 
     """

Modified: trunk/docutils/docutils/transforms/frontmatter.py
===================================================================
--- trunk/docutils/docutils/transforms/frontmatter.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/transforms/frontmatter.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -21,6 +21,8 @@
 .. _transforms: https://docutils.sourceforge.io/docs/api/transforms.html
 """
 
+from __future__ import annotations
+
 __docformat__ = 'reStructuredText'
 
 import re

Modified: trunk/docutils/docutils/transforms/misc.py
===================================================================
--- trunk/docutils/docutils/transforms/misc.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/transforms/misc.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -6,6 +6,8 @@
 Miscellaneous transforms.
 """
 
+from __future__ import annotations
+
 __docformat__ = 'reStructuredText'
 
 from docutils import nodes

Modified: trunk/docutils/docutils/transforms/parts.py
===================================================================
--- trunk/docutils/docutils/transforms/parts.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/transforms/parts.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -6,9 +6,10 @@
 Transforms related to document parts.
 """
 
+from __future__ import annotations
+
 __docformat__ = 'reStructuredText'
 
-
 import sys
 from docutils import nodes
 from docutils.transforms import Transform

Modified: trunk/docutils/docutils/transforms/peps.py
===================================================================
--- trunk/docutils/docutils/transforms/peps.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/transforms/peps.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -11,6 +11,8 @@
 - `PEPZero`: Special processing for PEP 0.
 """
 
+from __future__ import annotations
+
 __docformat__ = 'reStructuredText'
 
 import os

Modified: trunk/docutils/docutils/transforms/references.py
===================================================================
--- trunk/docutils/docutils/transforms/references.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/transforms/references.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -6,6 +6,8 @@
 Transforms for resolving references.
 """
 
+from __future__ import annotations
+
 __docformat__ = 'reStructuredText'
 
 from docutils import nodes, utils

Modified: trunk/docutils/docutils/transforms/universal.py
===================================================================
--- trunk/docutils/docutils/transforms/universal.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/transforms/universal.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -19,6 +19,8 @@
 - `Validate`: Validate the document tree, report violations as warning.
 """
 
+from __future__ import annotations
+
 __docformat__ = 'reStructuredText'
 
 import re

Modified: trunk/docutils/docutils/transforms/writer_aux.py
===================================================================
--- trunk/docutils/docutils/transforms/writer_aux.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/transforms/writer_aux.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -11,6 +11,7 @@
     from docutils import writers
     from docutils.transforms import writers
 """
+from __future__ import annotations
 
 __docformat__ = 'reStructuredText'
 

Modified: trunk/docutils/docutils/utils/code_analyzer.py
===================================================================
--- trunk/docutils/docutils/utils/code_analyzer.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/utils/code_analyzer.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -4,7 +4,10 @@
 
 """Lexical analysis of formal languages (i.e. code) using Pygments."""
 
-from docutils import ApplicationError
+from __future__ import annotations
+
+__docformat__ = 'reStructuredText'
+
 try:
     import pygments
     from pygments.lexers import get_lexer_by_name
@@ -13,6 +16,8 @@
 except ImportError:
     with_pygments = False
 
+from docutils import ApplicationError
+
 # Filter the following token types from the list of class arguments:
 unstyled_tokens = ['token',  # Token (base token type)
                    'text',   # Token.Text

Modified: trunk/docutils/docutils/utils/math/__init__.py
===================================================================
--- trunk/docutils/docutils/utils/math/__init__.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/utils/math/__init__.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -23,6 +23,10 @@
 :tex2mathml_extern: Wrapper for 3rd party TeX -> MathML converters
 """
 
+from __future__ import annotations
+
+__docformat__ = 'reStructuredText'
+
 # helpers for Docutils math support
 # =================================
 

Modified: trunk/docutils/docutils/utils/math/math2html.py
===================================================================
--- trunk/docutils/docutils/utils/math/math2html.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/utils/math/math2html.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -21,6 +21,10 @@
 #                    Support for more math commands from the AMS "math-guide".
 # 2.0    2021-12-31  Drop 2.7 compatibility code.
 
+from __future__ import annotations
+
+__docformat__ = 'reStructuredText'
+
 import pathlib
 import sys
 import unicodedata
@@ -27,7 +31,6 @@
 
 from docutils.utils.math import tex2unichar
 
-
 __version__ = '1.3 (2021-06-02)'
 
 

Modified: trunk/docutils/docutils/utils/math/mathml_elements.py
===================================================================
--- trunk/docutils/docutils/utils/math/mathml_elements.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/utils/math/mathml_elements.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -22,6 +22,10 @@
 .. _MathML Core: https://www.w3.org/TR/mathml-core/
 """
 
+from __future__ import annotations
+
+__docformat__ = 'reStructuredText'
+
 # Usage:
 #
 # >>> from mathml_elements import *

Modified: trunk/docutils/docutils/utils/math/tex2mathml_extern.py
===================================================================
--- trunk/docutils/docutils/utils/math/tex2mathml_extern.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/utils/math/tex2mathml_extern.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -15,6 +15,10 @@
 the API is not settled and may change with any minor Docutils version.
 """
 
+from __future__ import annotations
+
+__docformat__ = 'reStructuredText'
+
 import subprocess
 
 from docutils import nodes

Modified: trunk/docutils/docutils/utils/smartquotes.py
===================================================================
--- trunk/docutils/docutils/utils/smartquotes.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/utils/smartquotes.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -315,6 +315,8 @@
         - Initial release
 """
 
+from __future__ import annotations
+
 import re
 import sys
 

Modified: trunk/docutils/docutils/writers/docutils_xml.py
===================================================================
--- trunk/docutils/docutils/writers/docutils_xml.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/writers/docutils_xml.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -8,6 +8,8 @@
 https://docutils.sourceforge.io/docs/ref/docutils.dtd.
 """
 
+from __future__ import annotations
+
 __docformat__ = 'reStructuredText'
 
 from io import StringIO

Modified: trunk/docutils/docutils/writers/html4css1/__init__.py
===================================================================
--- trunk/docutils/docutils/writers/html4css1/__init__.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/writers/html4css1/__init__.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -12,6 +12,8 @@
 for proper viewing with a modern graphical browser.
 """
 
+from __future__ import annotations
+
 __docformat__ = 'reStructuredText'
 
 import os.path

Modified: trunk/docutils/docutils/writers/html5_polyglot/__init__.py
===================================================================
--- trunk/docutils/docutils/writers/html5_polyglot/__init__.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/writers/html5_polyglot/__init__.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -24,6 +24,9 @@
 The cascading style sheet "minimal.css" is required for proper viewing,
 the style sheet "plain.css" improves reading experience.
 """
+
+from __future__ import annotations
+
 __docformat__ = 'reStructuredText'
 
 from pathlib import Path

Modified: trunk/docutils/docutils/writers/manpage.py
===================================================================
--- trunk/docutils/docutils/writers/manpage.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/writers/manpage.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -41,6 +41,8 @@
 
 """
 
+from __future__ import annotations
+
 __docformat__ = 'reStructuredText'
 
 import re
@@ -359,11 +361,11 @@
                 # a) a line end, disable it
                 if self.body[i+1][0] in ('\n', '\r'):
                     self.body[i+1] = '.' + self.body[i+1]
-                # b) with a separator: moving the 1st char to current item
-                #    would require to check the second, use \c instead.
+                    # b) with a separator: moving the 1st char to current item
+                    #    would require to check the second, use \c instead.
                 else:
-                # append \c to end the text line, .ME or .UE without inserting
-                # space or attempting a break.
+                    # append \c to end the text line, .ME or .UE without
+                    # inserting space or attempting a break.
                     self.body[i] = "%s \\c\n" % (self.body[i][:3])
         return ''.join(self.head + self.body + self.foot)
 

Modified: trunk/docutils/docutils/writers/null.py
===================================================================
--- trunk/docutils/docutils/writers/null.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/writers/null.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -9,6 +9,10 @@
 in Docutils 0.22.
 """
 
+from __future__ import annotations
+
+__docformat__ = 'reStructuredText'
+
 from docutils import writers
 
 

Modified: trunk/docutils/docutils/writers/odf_odt/__init__.py
===================================================================
--- trunk/docutils/docutils/writers/odf_odt/__init__.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/writers/odf_odt/__init__.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -9,9 +9,10 @@
 the API is not settled and may change with any minor Docutils version.
 """
 
+from __future__ import annotations
+
 __docformat__ = 'reStructuredText'
 
-
 from configparser import ConfigParser
 import copy
 from io import StringIO

Modified: trunk/docutils/docutils/writers/odf_odt/prepstyles.py
===================================================================
--- trunk/docutils/docutils/writers/odf_odt/prepstyles.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/writers/odf_odt/prepstyles.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -11,6 +11,8 @@
 See https://docutils.sourceforge.io/docs/user/odt.html#page-size
 """
 
+from __future__ import annotations
+
 # Author: Michael Schutte <[email protected]>
 
 from xml.etree import ElementTree as ET

Modified: trunk/docutils/docutils/writers/odf_odt/pygmentsformatter.py
===================================================================
--- trunk/docutils/docutils/writers/odf_odt/pygmentsformatter.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/writers/odf_odt/pygmentsformatter.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -2,13 +2,10 @@
 # Author: Dave Kuhlman <[email protected]>
 # Copyright: This module has been placed in the public domain.
 
-"""
+"""Additional support for Pygments formatter."""
 
-Additional support for Pygments formatter.
+from __future__ import annotations
 
-"""
-
-
 import pygments
 import pygments.formatter
 

Modified: trunk/docutils/docutils/writers/pep_html/__init__.py
===================================================================
--- trunk/docutils/docutils/writers/pep_html/__init__.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/writers/pep_html/__init__.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -6,9 +6,10 @@
 PEP HTML Writer.
 """
 
+from __future__ import annotations
+
 __docformat__ = 'reStructuredText'
 
-
 import os
 import os.path
 

Modified: trunk/docutils/docutils/writers/pseudoxml.py
===================================================================
--- trunk/docutils/docutils/writers/pseudoxml.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/writers/pseudoxml.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -6,9 +6,10 @@
 Simple internal document tree Writer, writes indented pseudo-XML.
 """
 
+from __future__ import annotations
+
 __docformat__ = 'reStructuredText'
 
-
 from docutils import writers, frontend
 
 

Modified: trunk/docutils/docutils/writers/s5_html/__init__.py
===================================================================
--- trunk/docutils/docutils/writers/s5_html/__init__.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/writers/s5_html/__init__.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -6,6 +6,7 @@
 """
 S5/HTML Slideshow Writer.
 """
+from __future__ import annotations
 
 __docformat__ = 'reStructuredText'
 

Modified: trunk/docutils/docutils/writers/xetex/__init__.py
===================================================================
--- trunk/docutils/docutils/writers/xetex/__init__.py	2025-05-20 15:07:28 UTC (rev 10135)
+++ trunk/docutils/docutils/writers/xetex/__init__.py	2025-05-20 15:48:27 UTC (rev 10136)
@@ -20,6 +20,8 @@
 LuaTeX and XeTeX.
 """
 
+from __future__ import annotations
+
 __docformat__ = 'reStructuredText'
 
 from docutils import frontend

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