From d4aab17636b7eebc69f9c14b801a9abd35c20cd2 Mon Sep 17 00:00:00 2001 From: milde Date: Tue, 13 Dec 2016 08:27:53 +0000 Subject: Update release notes. Pre-announce at sphinx-devel. Build and upload wheels. git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@7997 929543f6-e4f2-0310-98a6-ba3bd3dd1d04 --- docs/dev/release.txt | 88 ++++++++++++++++------------------------------------ 1 file changed, 27 insertions(+), 61 deletions(-) (limited to 'docs/dev') diff --git a/docs/dev/release.txt b/docs/dev/release.txt index 54a997da9..499538d7b 100644 --- a/docs/dev/release.txt +++ b/docs/dev/release.txt @@ -65,9 +65,11 @@ Note on numbering (Feature Request #50) 0.13.1 -> when tagged for release 0.13.2a -> new head after release - Additionally snapshots can be marked with the .devXXX nominclature. + Additionally snapshots can be marked with the .devXXX nomenclature. -These can then all be pushed to pypi.python.org and by default pip will install the latest release unless explicitly requested via the --pre flag or a version specifier docutils>=0.13.1a +These can then all be pushed to pypi.python.org and by default pip will +install the latest release unless explicitly requested via the ``--pre`` +flag or a version specifier ``docutils>=0.13.1a`` REWORK FOR SOURCEFORGE REPO @@ -91,6 +93,9 @@ reminded of them. * **Announce a check-in freeze on Docutils-develop.** +* **Announce the upcoming release at the Sphinx-devel mailing list + and ask for testing with Sphinx.** + Call ``sandbox/infrastructure/release.sh new_version svn_version``. For details see the script. @@ -132,9 +137,6 @@ For details see the script. cd docutils python setup.py sdist - .. note:: PyPI recommends to `create and upload wheels`_ in addition to - the source tarball. - * Expand and _`install` the release tarball in isolation: (a) Expand the tarball in a new location, not over any existing @@ -203,51 +205,6 @@ For details see the script. Set the download-url so eggs can access older releases. - _`create and upload wheels`: - -* The `Python Packaging User Guide` recommends to provide `wheels`_ [#]_ in - addition to the source tarball. - - .. [#] A Built Distribution format introduced by pypa:PEP427s, which is - intended to replace the Egg format. Wheel is currently supported by - pip__. - - .. _wheels: https://packaging.python.org/en/latest/distributing.html#wheels - __ https://pypi.python.org/pypi/pip/ - - See also `feature request 43 - `__ - - For current Docutils, this would mean `pure Python wheels`__ for Python 2 - and 3 respectively. - - __ https://packaging.python.org/en/latest/distributing.html#pure-python-wheels - - - + Eventually install the `pip `__` and - `wheel `__ packages. - - + Produce wheels: - - For the default Python version: - - - From release at PyPI :: - - pip wheel docutils - - - From working directory's sub-directory "docutils" :: - - pip wheel ./docutils/ - - Under Debian, the default Python version is 2.7 and the wheel is usable - for all 2.x versions supported by Docutils and - the command ``pip3 wheel docutils`` generates a wheel suitable for Py3k. - - + `Upload to PyPI`__ - - __ https://packaging.python.org/en/latest/distributing.html#upload-your-distributions - - * Restore ``__version_details__`` in docutils/docutils/__init__.py to "repository" (from "release"). @@ -261,6 +218,26 @@ For details see the script. * **Run alltests.py with svn version** +* **build wheels**:: + + pip wheel docutils + pip3 wheel docutils + + This builds wheels_ (`pure Python wheels`_ for Python 2 and 3 + respectively) by downloading the new release from pypi. + + `Upload the wheels to PyPI`_. + + Question: Can we have an tar.gz (distutil) and a py2-wheel and a py3-wheel + on pypi and will installers select the correct files ? + + + .. _wheels: https://packaging.python.org/en/latest/distributing.html#wheels + .. _pure Python wheels: + https://packaging.python.org/en/latest/distributing.html#pure-python-wheels + .. _Upload the wheels to PyPI: + https://packaging.python.org/en/latest/distributing.html#upload-your-distributions + * **Send announcement email to:** * docutils-develop@lists.sourceforge.net (also announcing the end of @@ -279,17 +256,6 @@ For details see the script. __ http://freecode.com/projects/docutils/ -* **build a wheel** at least for python3:: - - pip3 wheel docutils - - This builds the wheel by downloading the new release from pypi. - - Upload the wheel to pypi. - - Question: Can we have an tar.gz (distutil) and a py2-wheel and a py3-wheel - on pypi and will installers select the correct files ? - .. Local Variables: -- cgit v1.2.1