CVS commit: pkgsrc/textproc/py-docutils

To: pkgsrc-changes%NetBSD.org@localhost
Subject: CVS commit: pkgsrc/textproc/py-docutils
From: "Thomas Klausner" <wiz%netbsd.org@localhost>
Date: Sun, 3 Aug 2025 10:06:37 +0000

Module Name:    pkgsrc
Committed By:   wiz
Date:           Sun Aug  3 10:06:37 UTC 2025

Modified Files:
        pkgsrc/textproc/py-docutils: Makefile PLIST distinfo

Log Message:
py-docutils: update to 0.22.

Release 0.22 (2026-07-29)
=========================

No changes to rc5.

Release 0.22rc5 (2025-06-24)
============================

* docutils/nodes.py

  - Don't invalidate indirect targets with duplicate name, if they refer to
    the same refname (similar to external targets refering to the same URI).

* docutils/parsers/rst/states.py

  - "Downgrade" targets generated from hyperlink references with embedded
    URI or alias from explicit to implicit (cf. bug #502).

Release 0.22rc4 (2025-06-17)
============================

* docutils/nodes.py

  - Don't include a "backlink" reference in system messages, if the
    referenced element is an external target (not visible in the output).

* docutils/parsers/rst/directives/references.py

  - Remove "name" from `TargetNotes.option_spec`.
    The "target-notes" directive generates one footnote element per
    external target but "name" must be unique across the document.
    So far, the name was silently dropped.

* docutils/parsers/rst/languages/en.py

  - Add alias "rst-class" for the "class" directive to improve the
    compatibility with Sphinx.

Release 0.22rc3 (2025-06-10)
============================

* docutils/parsers/rst/states.py

  - Warn about duplicate name in references with embedded internal targets.
    Fixes bug #502.

* docutils/transforms/references.py

  - New transform `CitationReferences`. Marks citation_references
    as resolved if BibTeX is used by the backend (LaTeX).

* docutils/writers/latex2e/__init__.py

  - Replace `Writer.bibtex_reference_resolver()` with a transform.
  - `LaTeXTranslator.visit_inline()` now inserts labels for the
    node's IDs.
  - Disable footnote handling by the "hyperref" LaTeX package (Docutils'
    ``\DUfootnotemark`` and ``\DUfootnotetext`` macros implement
    hyperlinks and backlinks).  Avoids "empty anchor" warnings.
  - Fix target position and re-style system messages.
  - Don't merge paragraphs if there is a target between them.

* docutils/writers/manpage.py

  - Do not drop text of internal targets.

Release 0.22rc2 (2025-05-22)
============================

* docutils/parsers/rst/directives/misc.py

  - Pass default settings to custom parser for included file.

* docutils/parsers/rst/states.py

  - Remove the `states.RSTStateMachine.memo.section_parents` cache
    (introduced in Docutils 0.22rc1) that broke 3rd-party applications
    employing a "mock memo".
  - Use `types.SimpleNamespace` instead of a local definition for
    the auxilliary class `states.Struct`.

* docutils/writers/_html_base.py

  - Fix error when determining the document metadata title from the
    source path and the internal `source` attribute is None.

Release 0.22rc1 (2025-05-06)
============================

* General

  - We have started to add type hints to Docutils (feature-request #87).

    This will be a complex programme of work and as such,
    for the time being, these type hints are "provisional"
    and should not be relied upon.

    By default, the Python interpreter treats type hints as annotations.
    Python >= 3.10 is required with active type hints
    (``typing.TYPE_CHECKING == True``).

* docs/ref/docutils.dtd

  - Allow multiple <term> elements in a <definition_list_item>.
    Fixes feature-request #60
  - The first element in a <figure> may also be a <reference>
    (with nested "clickable" <image>).

* docutils/core.py

  - Removed `Publisher.setup_option_parser()` (internal, obsolete).
  - Allow a string value (component name or alias) in the "reader",
    "parser", and "writer" arguments of `Publisher.__init__()` and
    the `publish_*()` convenience functions.

* docutils/frontend.py

  - Drop short options ``-i`` and ``-o`` for ``--input-encoding``
    and ``--output-encoding``.
  - Change the default input encoding from ``None`` (auto-detect) to "utf-8".
  - Change the default value of the root_prefix_ setting to the empty string
    (no change to the behaviour).

* docutils/io.py

  - Change the default input encoding from ``None`` (auto-detect) to "utf-8".

* docutils/nodes.py

  - Raise TypeError if the "rawsource" argument in `Element.__init__()`
    is an `Element` instance.
    Catches errors like ``nodes.hint(nodes.paragraph())``.
  - New element category classes `SubStructural` and `PureTextElement`.
  - Fix element categories.
  - New method `Element.validate()`: raise `nodes.ValidationError` if
    the element does not comply with the "Docutils Document Model".
    Provisional.
  - New "attribute validating functions"
    convert string representations to correct data type,
    normalize values, and
    raise ValueError for invalid attribute names or values.
  - New function `parse_measure()`.
  - Removed `Element.set_class()`.
  - Downgrade "duplicate ID" message level from SERIOUS to ERROR.
  - Fix recursion in `Element.get_language_code()`.
  - Do not insert <system_message> elements for duplicate explicit targets
    if this results in an invalid doctree (cf. bug #489).

* docutils/parsers/docutils_xml.py

  - New parser for Docutils XML sources. Provisional.

* docutils/parsers/recommonmark_wrapper.py

  - New method `Parser.finish_parse()` to clean up (before validating).

* docutils/parsers/rst/languages/

  - Remove mistranslations of the "admonition" directive name.

* docutils/parsers/rst/directives/__init__.py

  - Support CSS3 `length units`_. Fixes feature-request #57.

* docutils/parsers/rst/directives/images.py

  - New option "figname" for the "figure" directive.
    Fixes feature-request #44.

* docutils/parsers/rst/directives/misc.py

  - Pass the included file's path to the parser when the
    "include" directive is used with :parser: option.
    Enables system messages with correct source/line info.

* docutils/parsers/rst/directives/tables.py

  - Removed `CSVTable.decode_from_csv()` and `CSVTable.encode_from_csv()`.
    Not required with Python 3.

* docutils/parsers/rst/roles.py

  - Renamed `normalized_role_options()` to `normalize_options()`
    (it is now also used for directive options).

* docutils/parsers/rst/states.py

  - Raise warning for empty footnotes and citations.
  - Add source and line info to <enumerated-list> elements.
    Fix line number of "start value not ordinal-1" INFO message.
  - Change section handling to not rely on exceptions and reparsing.
    Based on patch #213 by Arne Skjærholt.
    Fixes bug #346 (duplicate System Messages).

* docutils/readers/__init__.py:

  - Deprecate "parser_name" argument of `Reader.__init__()`.

* docutils/transforms/frontmatter.py

  - Update `DocInfo` to work with corrected element categories.

* docutils/transforms/misc.py:

  - Fix for `misc.Transitions`: report an error if a <transition> element
    follows a <meta> or <decoration> element as this is invalid
    according to ``docutils.dtd``.

* docutils/transforms/writer_aux.py

  - Removed `Compound` transform.

* docutils/transforms/references.py

  - Make `AnonymousHyperlinks` transform idempotent.

* docutils/transforms/universal.py

  - `Messages` transform now also handles "loose" system messages
    generated by the parser.

* docutils/utils/__init__.py

  - Removed `Reporter.set_conditions()`.
    Set attributes via configuration settings or directly.

* docutils/utils/_roman_numerals.py

  - New implementation or Roman numeral support.
    Replaces the local copy of the roman.py package.

* docutils/utils/error_reporting.py

  - Removed. Obsolete in Python 3.

* docutils/writers/docutils-xml.py

  - Do not increase indentation of follow-up lines inside inline elements.
    when formatting with `indents`_.

* docutils/writers/__init__.py

  - New base class `writers.DoctreeTranslator`
    with auxiliary method `uri2path()`.

* docutils/writers/_html_base.py

  - Make MathML the default math_output_.
  - Revise image size handling methods,
    use "width" and "height" attributes for unitless values.
  - Add "px" to unitless table "width" values.

* docutils/writers/html4css1/__init__.py

  - Keep default math_output_ value "HTML math.css".
  - Add "px" to unitless table "width" values.

* docutils/writers/latex2e/__init__.py

  - `LaTeXTranslator.to_latex_length()`:
    Handle CSS3 `length units`_.
    Remove optional argument `pxunit` (ignored since at least 2012).
    Drop trailing zeroes from length values.
    Move XeTeX-specific code to the "xetex" writer.
  - Don't wrap references with custom reference-label_ in
    a ``\hyperref`` command.
  - Mark the main language when loading "babel".
  - Provide an "unknown_references_resolver" (cf. `docutils/TransformSpec`)
    for citation references resolved with BibTeX (cf. `use_bibtex`_ setting).
  - Support SVG image inclusion with the "svg" LaTeX package (see the
    `stylesheet`__ configuration setting). Solves feature-request #83
  - Add "template" to the parts returned by `Writer.assemble_parts()`.
  - Use standard `dict` for `LaTeXTranslator.requirements`
    and `LaTeXTranslator.fallbacks`.
  - Use <document> "title" attribute in pdfinfo.
  - Encode <meta> element content in pdfinfo.
  - Improve formatting of docinfo fields.
  - `LaTeXTranslator.pop_output_collector()` now returns the popped list.

  .. _reference-label: docs/user/config.html#reference-label
  __ docs/user/config.html#stylesheet-latex-writers

* docutils/writers/latex2e/docutils.sty

  - Replace use of ``\ifthenelse{\isundefined...`` (from "ifthen.sty")
    with the eTeX primitive ``\ifdefined``.
  - Add macros to emulate CSS3 `length units`_ unknown to LaTeX.

* docutils/writers/manpage.py

  - Remove code for unused emdash bullets.
  - Print Docutils version in header comment (feature-request #105).
  - Stop converting text to full capitals (bug #481).
  - Fix reference output (bug #497).
  - Use macros .UR/.UE for hyperlink references unless the new
    configuration setting text_references_ is True.
    The current default is True (text references), it will change
    to False (macro references) in Docutils 1.0.

* docutils/writers/null.py

  - `null.Writer.translate()` sets `self.output` to the empty string.

* docutils/writers/odf_odt/__init__.py

  - Use "px" as fallback unit for unitless image size attributes.
  - Fix conversion factor of "pc" (pica) to "cm".
  - Fix conversion of image width in "%" if the height is specified.
  - Adjust fallback DPI value (currently not used) to match CSS units.
  - Fix errors with ``*.xml`` style files (bug #494).
  - Use <document> "title" attribute in document metadata.

* pyproject.toml

  - Add tox.ini to the "include" list (fixes bug #486).

* tools/rst2odt.py

  - Use `core.publish_file()` instead of `core.publish_file_to_binary()`.

* tools/rst2odt_prepstyles.py

  - Removed. Use ``python -m docutils.writers.odf_odt.prepstyles``.

.. _length units: docs/ref/rst/restructuredtext.html#length-units


To generate a diff of this commit:
cvs rdiff -u -r1.66 -r1.67 pkgsrc/textproc/py-docutils/Makefile
cvs rdiff -u -r1.33 -r1.34 pkgsrc/textproc/py-docutils/PLIST
cvs rdiff -u -r1.32 -r1.33 pkgsrc/textproc/py-docutils/distinfo

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: pkgsrc/textproc/py-docutils/Makefile
diff -u pkgsrc/textproc/py-docutils/Makefile:1.66 pkgsrc/textproc/py-docutils/Makefile:1.67
--- pkgsrc/textproc/py-docutils/Makefile:1.66   Sun Feb 23 19:48:05 2025
+++ pkgsrc/textproc/py-docutils/Makefile        Sun Aug  3 10:06:37 2025
@@ -1,8 +1,7 @@
-# $NetBSD: Makefile,v 1.66 2025/02/23 19:48:05 wiz Exp $
+# $NetBSD: Makefile,v 1.67 2025/08/03 10:06:37 wiz Exp $
 
-DISTNAME=      docutils-0.21.2
+DISTNAME=      docutils-0.22
 PKGNAME=       ${PYPKGPREFIX}-${DISTNAME}
-PKGREVISION=   1
 CATEGORIES=    textproc python
 MASTER_SITES=  ${MASTER_SITE_PYPI:=d/docutils/}
 
@@ -12,13 +11,11 @@ COMMENT=    Python tool to generate documen
 LICENSE=       public-domain AND 2-clause-bsd
 
 TOOL_DEPENDS+= ${PYPKGPREFIX}-flit_core>=3.11:../../devel/py-flit_core
-DEPENDS+=      ${PYPKGPREFIX}-roman>=1.4:../../math/py-roman
 DEPENDS+=      ${PYPKGPREFIX}-pygments>=0:../../textproc/py-pygments
 
 USE_LANGUAGES= # none
 
 REPLACE_PYTHON+=       docutils/__main__.py
-REPLACE_PYTHON+=       docutils/utils/error_reporting.py
 REPLACE_PYTHON+=       docutils/utils/math/math2html.py
 REPLACE_PYTHON+=       docutils/utils/smartquotes.py
 REPLACE_PYTHON+=       docutils/writers/odf_odt/prepstyles.py

Index: pkgsrc/textproc/py-docutils/PLIST
diff -u pkgsrc/textproc/py-docutils/PLIST:1.33 pkgsrc/textproc/py-docutils/PLIST:1.34
--- pkgsrc/textproc/py-docutils/PLIST:1.33      Sun Feb 23 19:48:05 2025
+++ pkgsrc/textproc/py-docutils/PLIST   Sun Aug  3 10:06:37 2025
@@ -1,4 +1,4 @@
-@comment $NetBSD: PLIST,v 1.33 2025/02/23 19:48:05 wiz Exp $
+@comment $NetBSD: PLIST,v 1.34 2025/08/03 10:06:37 wiz Exp $
 bin/docutils-${PYVERSSUFFIX}
 bin/rst2html-${PYVERSSUFFIX}
 bin/rst2html4-${PYVERSSUFFIX}
@@ -14,7 +14,10 @@ ${PYSITELIB}/${WHEEL_INFODIR}/METADATA
 ${PYSITELIB}/${WHEEL_INFODIR}/RECORD
 ${PYSITELIB}/${WHEEL_INFODIR}/WHEEL
 ${PYSITELIB}/${WHEEL_INFODIR}/entry_points.txt
-${PYSITELIB}/${WHEEL_INFODIR}/licenses/COPYING.txt
+${PYSITELIB}/${WHEEL_INFODIR}/licenses/COPYING.rst
+${PYSITELIB}/${WHEEL_INFODIR}/licenses/licenses/BSD-0-Clause.rst
+${PYSITELIB}/${WHEEL_INFODIR}/licenses/licenses/BSD-2-Clause.rst
+${PYSITELIB}/${WHEEL_INFODIR}/licenses/licenses/gpl-3-0.txt
 ${PYSITELIB}/docutils/__init__.py
 ${PYSITELIB}/docutils/__init__.pyc
 ${PYSITELIB}/docutils/__init__.pyo
@@ -133,6 +136,9 @@ ${PYSITELIB}/docutils/parsers/__init__.p
 ${PYSITELIB}/docutils/parsers/commonmark_wrapper.py
 ${PYSITELIB}/docutils/parsers/commonmark_wrapper.pyc
 ${PYSITELIB}/docutils/parsers/commonmark_wrapper.pyo
+${PYSITELIB}/docutils/parsers/docutils_xml.py
+${PYSITELIB}/docutils/parsers/docutils_xml.pyc
+${PYSITELIB}/docutils/parsers/docutils_xml.pyo
 ${PYSITELIB}/docutils/parsers/null.py
 ${PYSITELIB}/docutils/parsers/null.pyc
 ${PYSITELIB}/docutils/parsers/null.pyo
@@ -169,7 +175,8 @@ ${PYSITELIB}/docutils/parsers/rst/direct
 ${PYSITELIB}/docutils/parsers/rst/directives/tables.py
 ${PYSITELIB}/docutils/parsers/rst/directives/tables.pyc
 ${PYSITELIB}/docutils/parsers/rst/directives/tables.pyo
-${PYSITELIB}/docutils/parsers/rst/include/README.txt
+${PYSITELIB}/docutils/parsers/rst/include/README.rst
+${PYSITELIB}/docutils/parsers/rst/include/html-roles.txt
 ${PYSITELIB}/docutils/parsers/rst/include/isoamsa.txt
 ${PYSITELIB}/docutils/parsers/rst/include/isoamsb.txt
 ${PYSITELIB}/docutils/parsers/rst/include/isoamsc.txt
@@ -347,12 +354,15 @@ ${PYSITELIB}/docutils/transforms/writer_
 ${PYSITELIB}/docutils/utils/__init__.py
 ${PYSITELIB}/docutils/utils/__init__.pyc
 ${PYSITELIB}/docutils/utils/__init__.pyo
+${PYSITELIB}/docutils/utils/_roman_numerals.py
+${PYSITELIB}/docutils/utils/_roman_numerals.pyc
+${PYSITELIB}/docutils/utils/_roman_numerals.pyo
+${PYSITELIB}/docutils/utils/_typing.py
+${PYSITELIB}/docutils/utils/_typing.pyc
+${PYSITELIB}/docutils/utils/_typing.pyo
 ${PYSITELIB}/docutils/utils/code_analyzer.py
 ${PYSITELIB}/docutils/utils/code_analyzer.pyc
 ${PYSITELIB}/docutils/utils/code_analyzer.pyo
-${PYSITELIB}/docutils/utils/error_reporting.py
-${PYSITELIB}/docutils/utils/error_reporting.pyc
-${PYSITELIB}/docutils/utils/error_reporting.pyo
 ${PYSITELIB}/docutils/utils/math/__init__.py
 ${PYSITELIB}/docutils/utils/math/__init__.pyc
 ${PYSITELIB}/docutils/utils/math/__init__.pyo
@@ -380,9 +390,6 @@ ${PYSITELIB}/docutils/utils/math/unichar
 ${PYSITELIB}/docutils/utils/punctuation_chars.py
 ${PYSITELIB}/docutils/utils/punctuation_chars.pyc
 ${PYSITELIB}/docutils/utils/punctuation_chars.pyo
-${PYSITELIB}/docutils/utils/roman.py
-${PYSITELIB}/docutils/utils/roman.pyc
-${PYSITELIB}/docutils/utils/roman.pyo
 ${PYSITELIB}/docutils/utils/smartquotes.py
 ${PYSITELIB}/docutils/utils/smartquotes.pyc
 ${PYSITELIB}/docutils/utils/smartquotes.pyo
@@ -448,7 +455,7 @@ ${PYSITELIB}/docutils/writers/pseudoxml.
 ${PYSITELIB}/docutils/writers/s5_html/__init__.py
 ${PYSITELIB}/docutils/writers/s5_html/__init__.pyc
 ${PYSITELIB}/docutils/writers/s5_html/__init__.pyo
-${PYSITELIB}/docutils/writers/s5_html/themes/README.txt
+${PYSITELIB}/docutils/writers/s5_html/themes/README.rst
 ${PYSITELIB}/docutils/writers/s5_html/themes/big-black/__base__
 ${PYSITELIB}/docutils/writers/s5_html/themes/big-black/framing.css
 ${PYSITELIB}/docutils/writers/s5_html/themes/big-black/pretty.css

Index: pkgsrc/textproc/py-docutils/distinfo
diff -u pkgsrc/textproc/py-docutils/distinfo:1.32 pkgsrc/textproc/py-docutils/distinfo:1.33
--- pkgsrc/textproc/py-docutils/distinfo:1.32   Sun Apr 28 09:55:06 2024
+++ pkgsrc/textproc/py-docutils/distinfo        Sun Aug  3 10:06:37 2025
@@ -1,5 +1,5 @@
-$NetBSD: distinfo,v 1.32 2024/04/28 09:55:06 wiz Exp $
+$NetBSD: distinfo,v 1.33 2025/08/03 10:06:37 wiz Exp $
 
-BLAKE2s (docutils-0.21.2.tar.gz) = dd5be04cf1a714c5e8f419367f95d1b125b18c485fdbefdb7d97bbb8a8bb9273
-SHA512 (docutils-0.21.2.tar.gz) = 7fafa331f5687448e80d299c20cdccc4b49819fa471b5f586bf0ab18c694ba43a70f58e7c76b0a70a16267585548389214e11a4998ad7fdc19a27f0f7644539c
-Size (docutils-0.21.2.tar.gz) = 2204444 bytes
+BLAKE2s (docutils-0.22.tar.gz) = 20d7b105f2af0a2417ab1e3800120565ef7c3fc77da8dd4ebef852624b7b3eaa
+SHA512 (docutils-0.22.tar.gz) = 09082eb3bdd5f9b3e977d356740efee47725a50fbaca7bf35c7fddff06003c2b2177a38d160a9956f9e96261f881c0d870c0aa9fef84f90d0cac079ccc73669d
+Size (docutils-0.22.tar.gz) = 2277984 bytes

Follow-Ups:
- Re: CVS commit: pkgsrc/textproc/py-docutils
  - From: Kimmo Suominen

Prev by Date: CVS commit: pkgsrc/doc
Next by Date: CVS commit: pkgsrc/doc
Previous by Thread: CVS commit: pkgsrc/doc
Next by Thread: Re: CVS commit: pkgsrc/textproc/py-docutils
Indexes:

Home | Main Index | Thread Index | Old Index