Tweak the release process--why not check for errors *before* regenerating

the topic index!
This commit is contained in:
Larry Hastings 2015-05-30 16:56:30 -07:00
parent 0998dbc553
commit 7fa4854058
1 changed files with 9 additions and 8 deletions

View File

@ -160,17 +160,18 @@ How to Make A Release
___ Make sure the current branch of your release clone is the branch you
want to release from.
___ Regenerate Lib/pydoc-topics.py.
cd to the Doc directory and type ``make pydoc-topics``. Then copy
``build/pydoc-topics/topics.py`` to ``../Lib/pydoc_data/topics.py``.
___ Check the docs for markup errors.
In the Doc directory, type ``make suspicious``. If any markup errors
are found, fix them.
cd to the Doc directory and run ``make suspicious``. If any markup
errors are found, fix them.
___ Commit any changes to pydoc_topics.py and the doc sources.
___ Regenerate Lib/pydoc-topics.py.
While still in the Doc directory, run ``make pydoc-topics``. Then copy
``build/pydoc-topics/topics.py`` to ``../Lib/pydoc_data/topics.py``.
___ Commit your changes to pydoc_topics.py
(and any fixes you made in the docs).
___ Make sure the SOURCE_URI in ``Doc/tools/pyspecific.py``
points to the right branch in the hg repository (or ``default`` for