summaryrefslogtreecommitdiff
path: root/docutils/docs/dev
diff options
context:
space:
mode:
authormilde <milde@929543f6-e4f2-0310-98a6-ba3bd3dd1d04>2017-08-10 17:51:01 +0000
committermilde <milde@929543f6-e4f2-0310-98a6-ba3bd3dd1d04>2017-08-10 17:51:01 +0000
commit4d1a5218b09fd98caaac6b3c4d9f78f1c50f5793 (patch)
treeed54ef1fb377c4d86dba77a633a9317d5c48dd3d /docutils/docs/dev
parent046dfee06c6f9f7db3255452d90d3d2134c17176 (diff)
downloaddocutils-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.txt2
-rw-r--r--docutils/docs/dev/release.txt2
-rw-r--r--docutils/docs/dev/testing.txt23
-rw-r--r--docutils/docs/dev/todo.txt19
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: