SF.net SVN: docutils:[10192 ] trunk/docutils
milde--- via Docutils-checkins <[email protected]> Wed, 30 Jul 2025 08:22:52 +0000
| Newsgroups | gmane.text.docutils.cvs |
|---|---|
| Message-ID | <[email protected]> |
Revision: 10192
http://sourceforge.net/p/docutils/code/10192
Author: milde
Date: 2025-07-30 08:22:51 +0000 (Wed, 30 Jul 2025)
Log Message:
-----------
Consolidate HISTORY and RELEASE NOTES for 0.22.
Merge entries for the 0.22 release candidates 1 to 5 into a common section
for relase 0.22.
Fix 0.22 release date. Thanks to Jeff McKenna for reporting.
Modified Paths:
--------------
trunk/docutils/HISTORY.rst
trunk/docutils/RELEASE-NOTES.rst
Modified: trunk/docutils/HISTORY.rst
===================================================================
--- trunk/docutils/HISTORY.rst 2025-07-30 08:22:43 UTC (rev 10191)
+++ trunk/docutils/HISTORY.rst 2025-07-30 08:22:51 UTC (rev 10192)
@@ -17,102 +17,12 @@
Release 0.23b0 (unpublished)
============================
-.
+...
+
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).
@@ -171,6 +81,10 @@
- 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).
+ - Don't include a "backlink" reference in system messages, if the
+ referenced element is an external target (not visible in the output).
+ - 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/docutils_xml.py
@@ -184,6 +98,11 @@
- Remove mistranslations of the "admonition" directive name.
+* docutils/parsers/rst/languages/en.py
+
+ - Add alias "rst-class" for the "class" directive to improve the
+ compatibility with Sphinx.
+
* docutils/parsers/rst/directives/__init__.py
- Support CSS3 `length units`_. Fixes feature-request #57.
@@ -198,7 +117,15 @@
- 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.
+ - Pass default settings to custom parser for included file.
+* 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/directives/tables.py
- Removed `CSVTable.decode_from_csv()` and `CSVTable.encode_from_csv()`.
@@ -217,6 +144,12 @@
- Change section handling to not rely on exceptions and reparsing.
Based on patch #213 by Arne Skjærholt.
Fixes bug #346 (duplicate System Messages).
+ - Use `types.SimpleNamespace` instead of a local definition for
+ the auxilliary class `states.Struct`.
+ - Warn about duplicate name in references with embedded internal targets.
+ Fixes bug #502.
+ - "Downgrade" targets generated from hyperlink references with embedded
+ URI or alias from explicit to implicit (cf. bug #502).
* docutils/readers/__init__.py:
@@ -232,6 +165,11 @@
follows a <meta> or <decoration> element as this is invalid
according to ``docutils.dtd``.
+* docutils/transforms/references.py
+
+ - New transform `CitationReferences`. Marks citation_references
+ as resolved if BibTeX is used by the backend (LaTeX).
+
* docutils/transforms/writer_aux.py
- Removed `Compound` transform.
@@ -275,6 +213,8 @@
- Revise image size handling methods,
use "width" and "height" attributes for unitless values.
- Add "px" to unitless table "width" values.
+ - Fix error when determining the document metadata title from the
+ source path and the internal `source` attribute is None.
* docutils/writers/html4css1/__init__.py
@@ -302,6 +242,14 @@
- Encode <meta> element content in pdfinfo.
- Improve formatting of docinfo fields.
- `LaTeXTranslator.pop_output_collector()` now returns the popped list.
+ - 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.
.. _reference-label: docs/user/config.html#reference-label
__ docs/user/config.html#stylesheet-latex-writers
@@ -322,6 +270,7 @@
configuration setting text_references_ is True.
The current default is True (text references), it will change
to False (macro references) in Docutils 1.0.
+ - Do not drop text of internal targets.
* docutils/writers/null.py
Modified: trunk/docutils/RELEASE-NOTES.rst
===================================================================
--- trunk/docutils/RELEASE-NOTES.rst 2025-07-30 08:22:43 UTC (rev 10191)
+++ trunk/docutils/RELEASE-NOTES.rst 2025-07-30 08:22:51 UTC (rev 10192)
@@ -210,6 +210,9 @@
`states.RSTState.title_inconsistent()`, and `states.Line.eofcheck`
in Docutils 2.0. Ignored since Docutils 0.22.
+* Remove `parsers.rst.states.Struct` (obsoleted by `types.SimpleNamespace`)
+ in Docutils 2.0.
+
* Remove `frontend.OptionParser`, `frontend.Option`, `frontend.Values`,
`frontend.store_multiple()`, and `frontend.read_config_file()` when
migrating to argparse_ in Docutils 2.0 or later.
@@ -253,71 +256,31 @@
Release 0.23b0 (unpublished)
============================
-.
+...
-Release 0.22 (2026-07-29)
+
+Release 0.22 (2025-07-29)
=========================
-No changes to rc5.
-
-Release 0.22rc5 (2025-06-24)
-============================
-
-Targets generated from hyperlink references with embedded URI or alias
-are no longer "explicit" but "implicit" (i.e. with the same priority as
-auto-generated section targets, see `implicit hyperlink targets`__).
-
-__ https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html
- #implicit-hyperlink-targets
-
-Don't report an error for duplicate targets with identical refname.
-
-Release 0.22rc4 (2025-06-17)
-============================
-
-Drop the "name" option of the "target-notes" directive.
-(Report an error instead of silently ignoring the value.)
-
-New alias "rst-class" for the `"class"`_ directive to improve the
-compatibility with Sphinx.
-
-
-Release 0.22rc3 (2025-06-10)
-============================
-
-New objects
- `transforms.references.CitationReferences`
- Mark citation_references as resolved if the backend
- uses a BibTeX database.
-
-Output changes
-
- manpage:
- Do not drop text of internal targets.
-
-
-Release 0.22rc2 (2025-05-22)
-============================
-
-Fix backwards-compatibility problem:
- reStructuredText section parsing no longer requires
- `parsers.rst.states.RSTStateMachine.memo.section_parents`
- (a cache introduced in Docutils 0.22rc1).
-
-Deprecate `parsers.rst.states.Struct` (obsoleted by `types.SimpleNamespace`).
-
-
-Release 0.22rc1 (2025-05-06)
-============================
-
reStructuredText:
- Support `CSS3 units`_. This adds "ch", "rem", "vw", "vh", "vmin",
"vmax", and "Q" to the `supported length units`__. Note that some
output formats don't support all units.
- New option "figname" for the `"figure"`_ directive.
+ - Targets generated from hyperlink references with embedded URI or
+ alias are no longer "explicit" but "implicit" (i.e. with the same
+ priority as auto-generated section targets, see `implicit hyperlink
+ targets`__).
+ - Don't report an error for duplicate targets with identical refname.
+ - Drop the "name" option of the "target-notes" directive.
+ (Report an error instead of silently ignoring the value.)
+ - New alias "rst-class" for the `"class"`_ directive to improve the
+ compatibility with Sphinx.
.. _CSS3 units: https://www.w3.org/TR/css-values-3/#lengths
__ docs/ref/rst/restructuredtext.html#length-units
+ __ https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html
+ #implicit-hyperlink-targets
Document Tree / Docutils DTD
- Allow multiple <term> elements in a `\<definition_list_item>`__
@@ -384,6 +347,10 @@
the `Docutils Document Model`_.
Provisional.
+ `transforms.references.CitationReferences`
+ Mark citation_references as resolved if the backend
+ uses a BibTeX database.
+
`writers.DoctreeTranslator`
Generic Docutils document tree translator base class with
`uri2path()` auxiliary method.
This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.
_______________________________________________
Docutils-checkins mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/docutils-checkins