summaryrefslogtreecommitdiff
path: root/docs/change_log/release-3.2.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/change_log/release-3.2.md')
-rw-r--r--docs/change_log/release-3.2.md19
1 files changed, 10 insertions, 9 deletions
diff --git a/docs/change_log/release-3.2.md b/docs/change_log/release-3.2.md
index 4f43385..7b7caf2 100644
--- a/docs/change_log/release-3.2.md
+++ b/docs/change_log/release-3.2.md
@@ -2,8 +2,8 @@ title: Release Notes for v3.2
# Python-Markdown 3.2 Release Notes
-Python-Markdown version 3.2 supports Python versions 3.5, 3.6, 3.7, 3.8,
-PyPy and PyPy3.
+Python-Markdown version 3.2 supports Python versions 3.5, 3.6, 3.7, 3.8, and
+PyPy3.
## Backwards-incompatible changes
@@ -38,11 +38,11 @@ Before, the HTML generated by CodeHilite looked like:
- `<pre><code>foo = 'bar'</code></pre>` if you **were not** using Pygments.
- `<pre>foo = 'bar'</pre>` if you **were** using Pygments.
-To make the cases more consistent (and adhere to many Markdown specifications and
+To make the cases more consistent (and adhere to many Markdown specifications and
HTML code block markup suggestions), CodeHilite will now always additionally wrap
code with `<code>` tags. See #862 for more details.
-This change does not alter the Python-Markdown API, but users relying on the old
+This change does not alter the Python-Markdown API, but users relying on the old
markup will find their output now changed.
Internally, this change relies on the Pygments 2.4, so you must be using at least
@@ -54,10 +54,10 @@ continue to see the old behavior.
Previously, Python-Markdown was using either the `xml.etree.cElementTree` module
or the `xml.etree.ElementTree` module, based on their availability. In modern
Python versions, the former is a deprecated alias for the latter. Thus, the
-compatibility layer is deprecated and extensions are advised to use
+compatibility layer is deprecated and extensions are advised to use
`xml.etree.ElementTree` directly. Importing `markdown.util.etree` will raise
a `DeprecationWarning` beginning in version 3.2 and may be removed in a future
-release.
+release.
Therefore, extension developers are encouraged to replace
`from markdown.util import etree` with
@@ -71,9 +71,9 @@ The following new features have been included in the release:
extension:
* The `anchorlink_class` and `permalink_class` options allow class(es) to be
- assigned to the `anchorlink` and `permalink` respectively. This allows using
- icon fonts from CSS for the links. Therefore, an empty string passed to
- `permalink` now generates an empty `permalink`. Previously no `permalink`
+ assigned to the `anchorlink` and `permalink` respectively. This allows using
+ icon fonts from CSS for the links. Therefore, an empty string passed to
+ `permalink` now generates an empty `permalink`. Previously no `permalink`
would have been generated. (#776)
* The `permalink_title` option allows the title attribute of a `permalink` to be
@@ -90,6 +90,7 @@ The following new features have been included in the release:
The following bug fixes are included in the 3.2 release:
+* HTML tag placeholders are no longer included in `.toc_tokens` (#899).
* Unescape backslash-escaped characters in TOC ids (#864).
* Refactor bold and italic logic in order to solve complex nesting issues (#792).
* Always wrap CodeHilite code in <code> tags (#862).