/usr/share/doc/python-markdown-doc/docs/release-2.3.html is in python-markdown-doc 2.6.6-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 | <!DOCTYPE html>
<html>
<head>
<meta charset=utf-8>
<title>Release Notes for v2.3 — Python Markdown</title>
<link rel="stylesheet" href="default.css" type="text/css">
</head>
<body>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="siteindex.html" title="General Index">index</a></li>
<li class="right">
<a href="release-2.2.1.html" title="Release Notes for v2.2.1"
accesskey="N">next</a> |</li>
<li class="right">
<a href="release-2.4.html" title="Release Notes for v2.4"
accesskey="P">previous</a> |</li>
<li><img src="py.png" alt=""
style="vertical-align: middle; margin-top: -1px"/></li>
<li><a href="index.html">Python Markdown v2.6.6 documentation</a> »</li>
<li><a href="release-2.3.html">Release Notes for v2.3</a> »</li>
</ul>
</div> <!-- .related -->
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body">
<h1 id="python-markdown-23-release-notes">Python-Markdown 2.3 Release Notes<a class="headerlink" href="#python-markdown-23-release-notes" title="Permanent link">¶</a></h1>
<p>We are pleased to release Python-Markdown 2.3 which adds one new extension,
removes a few old (obsolete) extensions, and now runs on both Python 2 and
Python 3 without running the 2to3 conversion tool. See the list of changes
below for details.</p>
<p>Python-Markdown supports Python versions 2.6, 2.7, 3.1, 3.2, and 3.3.</p>
<h2 id="backwards-incompatible-changes">Backwards-incompatible Changes<a class="headerlink" href="#backwards-incompatible-changes" title="Permanent link">¶</a></h2>
<ul>
<li>
<p>Support has been dropped for Python 2.5. No guarantees are made that the
library will work in any version of Python lower than 2.6. As all supported
Python versions include the ElementTree library, Python-Markdown will no
longer try to import a third-party installation of ElementTree.</p>
</li>
<li>
<p>All classes are now “new-style” classes. In other words, all classes
subclass from ‘object’. While this is not likely to affect most users,
extension authors may need to make a few minor adjustments to their code.</p>
</li>
<li>
<p>“safe_mode” has been further restricted. Markdown formatted links must be
of a known white-listed scheme when in “safe_mode” or the URL is discarded.
The white-listed schemes are: ‘HTTP’, ‘HTTPS’, ‘FTP’, ‘FTPS’, ‘MAILTO’, and
‘news’. Schemeless URLs are also permitted, but are checked in other ways -
as they have been for some time.</p>
</li>
<li>
<p>The ids assigned to footnotes now contain a dash (<code>-</code>) rather than a colon
(<code>:</code>) when <code>output_format</code> it set to <code>"html5"</code> or <code>"xhtml5"</code>. If you are making
reference to those ids in your JavaScript or CSS and using the HTML5 output,
you will need to update your code accordingly. No changes are necessary if
you are outputting XHTML (the default) or HTML4.</p>
</li>
<li>
<p>The <code>force_linenos</code> configuration setting of the CodeHilite extension has been
marked as <strong>Pending Deprecation</strong> and a new setting <code>linenums</code> has been added to
replace it. See documentation for the <a href="extensions/codehilite.html">CodeHilite Extension</a> for an explanation
of the new <code>linenums</code> setting. The new setting will honor the old
<code>force_linenos</code> if it is set, but it will raise a <code>PendingDeprecationWarning</code>
and will likely be removed in a future version of Python-Markdown.</p>
</li>
<li>
<p>The “RSS” extension has been removed and no longer ships with Python-Markdown.
If you would like to continue using the extension (not recommended), it is
archived on <a href="https://gist.github.com/waylan/4773365">GitHub</a>.</p>
</li>
<li>
<p>The “HTML Tidy” Extension has been removed and no longer ships with Python-Markdown.
If you would like to continue using the extension (not recommended), it is
archived on <a href="https://gist.github.com/waylan/5152650">GitHub</a>. Note that the
underlying library, uTidylib, is not Python 3 compatible. Instead, it is
recommended that the newer <a href="http://countergram.com/open-source/pytidylib">PyTidyLib</a> (version 0.2.2+ for Python 3
comparability - install from GitHub not PyPI) be used. As the API for that
library is rather simple, it is recommended that the output of Markdown be
wrapped in a call to PyTidyLib rather than using an extension (for example:
<code>tidylib.tidy_fragment(markdown.markdown(source), options={...})</code>).</p>
</li>
</ul>
<h2 id="whats-new-in-python-markdown-23">What’s New in Python-Markdown 2.3<a class="headerlink" href="#whats-new-in-python-markdown-23" title="Permanent link">¶</a></h2>
<ul>
<li>
<p>The entire code base now universally runs in Python 2 and Python 3 without
any need for running the 2to3 conversion tool. This not only simplifies testing,
but by using Unicode_literals, results in more consistent behavior across
Python versions. Additionally, the relative imports (made possible in Python 2
via absolute_import) allows the entire library to more easily be embedded in a
sub-directory of another project. The various files within the library will
still import each other properly even though ‘markdown’ may not be in Python’s
root namespace.</p>
</li>
<li>
<p>The <a href="extensions/admonition.html">Admonition Extension</a> has been added, which implements <a href="http://docutils.sourceforge.net/docs/ref/rst/directives.html#specific-admonitions">rST-style</a>
admonitions in the Markdown syntax. However, be warned that this extension
is experimental and the syntax and behavior is still subject to change. Please
try it out and report bugs and/or improvements.</p>
</li>
<li>
<p>Various bug fixes have been made. See the
<a href="https://github.com/waylan/Python-Markdown/commits/master">commit log</a>
for a complete history of the changes.</p>
</li>
</ul>
</div> <!-- .body -->
</div> <!-- .bodywrapper -->
</div> <!-- .documentwrapper -->
<div class="sphinxsidebar">
<div class="sphinxsidebarwrapper">
<h3>Table Of Contents</h3>
<div class="toc">
<ul>
<li><a href="#python-markdown-23-release-notes">Python-Markdown 2.3 Release Notes</a><ul>
<li><a href="#backwards-incompatible-changes">Backwards-incompatible Changes</a></li>
<li><a href="#whats-new-in-python-markdown-23">What's New in Python-Markdown 2.3</a></li>
</ul>
</li>
</ul>
</div>
<h4>Previous topic</h4>
<p class="topless"><a href="release-2.4.html"
title="previous chapter">Release Notes for v2.4</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="release-2.2.1.html"
title="next chapter">Release Notes for v2.2.1</a></p>
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="https://github.com/waylan/Python-Markdown/issues"
>Report a Bug</a></li>
<li><a href="release-2.3.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div> <!-- .sphinxsidebarwrapper -->
</div> <!-- .sphinxsidebar -->
<div class="clearer"></div>
</div> <!-- .document -->
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="siteindex.html" title="General Index">index</a></li>
<li class="right">
<a href="release-2.2.1.html" title="Release Notes for v2.2.1"
accesskey="N">next</a> |</li>
<li class="right">
<a href="release-2.4.html" title="Release Notes for v2.4"
accesskey="P">previous</a> |</li>
<li><img src="py.png" alt=""
style="vertical-align: middle; margin-top: -1px"/></li>
<li><a href="index.html">Python Markdown v2.6.6 documentation</a> »</li>
<li><a href="release-2.3.html">Release Notes for v2.3</a> »</li>
</ul>
</div> <!-- .related -->
<div class="footer">© 2010-2012 Python Markdown Project</div>
</body>
</html>
|