diff options
| author | milde <milde@929543f6-e4f2-0310-98a6-ba3bd3dd1d04> | 2017-08-10 17:51:01 +0000 |
|---|---|---|
| committer | milde <milde@929543f6-e4f2-0310-98a6-ba3bd3dd1d04> | 2017-08-10 17:51:01 +0000 |
| commit | 4d1a5218b09fd98caaac6b3c4d9f78f1c50f5793 (patch) | |
| tree | ed54ef1fb377c4d86dba77a633a9317d5c48dd3d /docutils/docs/dev | |
| parent | 046dfee06c6f9f7db3255452d90d3d2134c17176 (diff) | |
| download | docutils-4d1a5218b09fd98caaac6b3c4d9f78f1c50f5793.tar.gz | |
Documentation update: Dropped support for Python 2.4, 2.5, 3.1, and 3.2.
No change to the code yet, but from now on constructs requiring 2.6 or later
can be checked in.
git-svn-id: http://svn.code.sf.net/p/docutils/code/trunk@8162 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
Diffstat (limited to 'docutils/docs/dev')
| -rw-r--r-- | docutils/docs/dev/distributing.txt | 2 | ||||
| -rw-r--r-- | docutils/docs/dev/release.txt | 2 | ||||
| -rw-r--r-- | docutils/docs/dev/testing.txt | 23 | ||||
| -rw-r--r-- | docutils/docs/dev/todo.txt | 19 |
4 files changed, 26 insertions, 20 deletions
diff --git a/docutils/docs/dev/distributing.txt b/docutils/docs/dev/distributing.txt index 770e83de5..3aeb6af24 100644 --- a/docutils/docs/dev/distributing.txt +++ b/docutils/docs/dev/distributing.txt @@ -28,7 +28,7 @@ Dependencies Docutils has the following dependencies: -* Python 2.4 or later is required. Use ">= Python 2.4" in the +* Python 2.6 or later is required. Use ">= Python 2.6" in the dependencies. * Docutils may optionally make use of the PIL (`Python Imaging diff --git a/docutils/docs/dev/release.txt b/docutils/docs/dev/release.txt index cd1f621c9..3671cc851 100644 --- a/docutils/docs/dev/release.txt +++ b/docutils/docs/dev/release.txt @@ -13,7 +13,7 @@ Assumptions and their failure ----------------------------- -On the test machine python2.4, 2.5, 2.6, 2.7 and 3.2, 3.3, and 3.4 +On the test machine python 2.6, 2.7 and 3.2, 3.3, and 3.4 are installed. Some in /usr/ some under /usr/local. diff --git a/docutils/docs/dev/testing.txt b/docutils/docs/dev/testing.txt index e3767aadf..f9d326b52 100644 --- a/docutils/docs/dev/testing.txt +++ b/docutils/docs/dev/testing.txt @@ -38,28 +38,25 @@ Python 3, ``cd`` to the package's root directory and do:: Python Versions =============== -A docutils release has a commitment to support a minimum version and +A docutils release has a commitment to support a minimum version and beyond. Before a release is cut, tests must pass in all supported python versions. -The Docutils 0.10 release supports Python 2.4 or later. -Versions after 0.12 will drop python 2.4, supporting **2.5** and later. +The Docutils 0.15 release supports Python 2.6 or later. -Therefore, you should install python 2.5, as well as the latest Python -(3.4 at the time of this writing) installed and always run the tests on -all of them. In a pinch, the edge cases (2.5, and 3.4) should cover most -of it. +Therefore, you should install python 2.6, 2.7 as well as 3.3 up to the +latest Python (3.5 at the time of this writing) installed and always run the +tests on all of them. In a pinch, the edge cases (2.6, and 3.5) should cover +most of it. Good resources covering the differences between Python versions: -* `What's New in Python 2.5`__ * `What's New in Python 2.6`__ * `What's New in Python 2.7`__ * `What's New in Python 3.3`__ * `What's New in Python 3.4`__ * `PEP 290 - Code Migration and Modernization`__ -__ http://www.python.org/doc/2.5.2/whatsnew/whatsnew25.html __ http://docs.python.org/whatsnew/2.6.html __ http://docs.python.org/whatsnew/2.7.html __ https://docs.python.org/3/whatsnew/3.3.html @@ -75,14 +72,14 @@ __ http://www.python.org/peps/pep-0290.html Testing across multiple python versions --------------------------------------- -`pyenv`_ can be installed and configured (see `installing pyenv`_) to +`pyenv`_ can be installed and configured (see `installing pyenv`_) to test multiple python versions:: # assuming your system runs 2.7.x pyenv install 2.6.9 pyenv install 3.3.6 pyenv install 3.4.3 - pyenv global system 2.5.6 2.6.9 3.3.6 3.4.3 + pyenv global system 2.6.9 3.3.6 3.4.3 # reset your shims rm -rf ~/.pyenv/shims && pyenv rehash @@ -90,15 +87,13 @@ test multiple python versions:: This will give you ``python2.6``, ``python2.7``, ``python3.3`` and ``python3.4``. Along with that, ``pip2.6``, ``pip2.7`` and so on. -To save time, you can use `tox`_ to test docutils on versions 2.6+. To +To save time, you can use `tox`_. To install tox, you can use ``easy_install tox`` or ``pip install tox``. From shell:: cd docutils tox -Note: tox and virtualenv only supports python 2.6 and onward. - .. _tox: https://tox.readthedocs.org/en/latest/ .. _pyenv: https://github.com/yyuu/pyenv .. _installing pyenv: https://github.com/yyuu/pyenv#installation diff --git a/docutils/docs/dev/todo.txt b/docutils/docs/dev/todo.txt index 2e51d4851..d938bc111 100644 --- a/docutils/docs/dev/todo.txt +++ b/docutils/docs/dev/todo.txt @@ -75,8 +75,6 @@ General (Cf. `Porting Python 2 Code to Python 3`_ and `clean single-source support for Python 2/3`_.) - - Gradually phase out support for Python 2.4 and 2.5 first. - .. _Porting Python 2 Code to Python 3: https://docs.python.org/3/howto/pyporting.html .. _clean single-source support for Python 2/3: @@ -1307,6 +1305,9 @@ MathML_ .. _mathweb wiki: http://www.mathweb.org/wiki/MathML .. _ConTeXT MathML page: http://wiki.contextgarden.net/MathML + A MathML to LaTeX XSLT sheet: + https://github.com/davidcarlisle/web-xslt/tree/master/pmml2tex + ASCIIMath_ Simple, ASCII based math input language (see also `ASCIIMath tutorial`_). @@ -1317,8 +1318,18 @@ ASCIIMath_ A more comprehensive implementation is ASCIIMathPython_ by Paul Trembley (also used in his sandbox projects). - * For conversion to LaTeX, there is a JavaScript script at - http://dlippman.imathas.com/asciimathtex/ASCIIMath2TeX.js + * For conversion to LaTeX, there is + + - a JavaScript script at + http://dlippman.imathas.com/asciimathtex/ASCIIMath2TeX.js + + - The javascript `asciimath-to-latex` AsciiMath to LaTex converter at + the node package manager + https://www.npmjs.com/package/asciimath-to-latex + and at GitHub https://github.com/tylerlong/asciimath-to-latex + + - a javascript and a PHP converter script at GitHub + https://github.com/asciimath/asciimathml/tree/master/asciimath-based .. _ASCIIMath: http://www1.chapman.edu/~jipsen/mathml/asciimath.html .. _ASCIIMath tutorial: |
