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

Revision: 10149
          http://sourceforge.net/p/docutils/code/10149
Author:   milde
Date:     2025-05-27 06:17:51 +0000 (Tue, 27 May 2025)
Log Message:
-----------
Announce upcoming changes to the default transforms.

Modified Paths:
--------------
    trunk/docutils/RELEASE-NOTES.rst
    trunk/docutils/docs/api/transforms.rst

Modified: trunk/docutils/RELEASE-NOTES.rst
===================================================================
--- trunk/docutils/RELEASE-NOTES.rst	2025-05-27 06:17:22 UTC (rev 10148)
+++ trunk/docutils/RELEASE-NOTES.rst	2025-05-27 06:17:51 UTC (rev 10149)
@@ -167,6 +167,12 @@
   in Docutils 1.0.  Use a transform_,
   see `transforms.references.CitationReferences` for an example.
 
+* Ignore `transforms.references.DanglingReferences` and
+  `transforms.references.DanglingReferencesVisitor` in Docutils 1.0;
+  remove them in Docutils 2.0. [rationale__]
+
+  __ docs/api/transforms.html#dangling
+
 * Remove `parsers.rst.roles.set_classes()` and
   `parsers.rst.roles.normalized_role_options()`
   (obsoleted by `parsers.rst.roles.normalize_options()`) in Docutils 2.0.
@@ -208,6 +214,9 @@
 
   __ docs/api/publisher.html#string-i-o
 
+* Change the default priority of the `universal.SmartQuotes` transform_
+  from 855 (very late) to 510 (main) in Docutils 1.0.
+
 * Move math format conversion from docutils/utils/math (called from
   docutils/writers/_html_base.py) to a transform_.
 

Modified: trunk/docutils/docs/api/transforms.rst
===================================================================
--- trunk/docutils/docs/api/transforms.rst	2025-05-27 06:17:22 UTC (rev 10148)
+++ trunk/docutils/docs/api/transforms.rst	2025-05-27 06:17:51 UTC (rev 10149)
@@ -110,7 +110,8 @@
 
 universal_.ExposeInternals          readers_ (r)                  _`840`
 
-references_.DanglingReferences      standalone_ (r), pep_ (r)     _`850`
+references_.DanglingReferences      standalone_ (r), pep_ (r),    _`850`
+                                    *deprecated* [#dangling]_
 
 universal_.SmartQuotes              rst_ (p)                      _`855`
 
@@ -136,7 +137,17 @@
 * (t): Transform
 * (/p): Via a `\<pending>`_ element
 
+.. [#dangling] `references.DanglingReferences` will be split into a
+   transform resolving refnames__ to refids__ and a transform reporting
+   unresolved references to make space for reference-resolving transforms
+   added by extensions or applications
+   (cf. `Release Notes`__).
 
+   __ ../ref/doctree.html#refname
+   __ ../ref/doctree.html#refid
+   __ ../../RELEASE-NOTES.html#removals
+
+
 Transform Priority Range Categories
 -----------------------------------
 

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