Delete cut/paste command sequence; make commands more obvious

You couldn't actually cut/paste the commands as there were intemediate
steps that had to be done.

Moved commands into the release list. All commands are indented and
surrounded by blank lines to make cutting/pasting easier.

Author: rouilj

RELEASE.txt

@@ -12,14 +12,18 @@ Roundup release checklist:
     advance of the release to allow for translators to update their
     translations. Merge into .po files by running 'make *.po'
     in the locale directory. Run:
+
        make template
        make *.po
+
 2.  Run unit tests! They should pass successfully. Install pytest
     using pip2/pip3 for python2 and python3. Then invoke pytest
     using both python versions from the top of the roundup tree:
+
         python3 -m pytest test/
         python2 -m pytest test/
-3.  Update version
+
+3.  Update version in:
       CHANGES.txt
       roundup/__init__.py
       website/www/index.txt
@@ -39,34 +43,54 @@ Roundup release checklist:
     beta alpha etc.
 
     Check that metadata is valid and long descriptions is proper reST:
+
       python setup.py check --restructuredtext --metadata --strict
+   
 6.  Clean out all *.orig, *.rej, .#* files from the source.
-6a. Rebuild .mo translation files in distribution - cd locale; make
+
+      find . -name '*.orig' -exec rm {} \;
+      find . -name '*.rej' -exec rm {} \;
+      find . -name '.#*' -exec rm {} \;
+
+6a. Rebuild .mo translation files in distribution
+
+      cd locale
+      make
+      cd ..
+
 7.  Remove previous build files
+
       python setup.py clean --all
       rm -rf build/share  # deletes locale .mo files
-    Rebuild and install .mo files
-      python setup.py build  (sdist generation will fail if this isn't done)
-8.  Check documentation:
-    python setup.py check --restructuredtext --metadata --strict
-    Rebuild documentation in "share/doc/roundup/html"
+
+    Build including new .mo files built in 6a.
+
+      python setup.py build
+
+    (sdist generation will fail if this isn't done)
+8.  Rebuild documentation in "share/doc/roundup/html"
+
       python setup.py build_doc
-9.  python setup.py sdist
+
+9.  Generate source distribution:
+
+      python setup.py sdist
+
     (if you find sdist a little verbose, add "--quiet" to the end of the
      command)
 9a. 2021/04/17 skip this for now. Need to make sure that whl installs
-    execuable scripts properly and update these directions to test.
+    exectuable scripts properly and update these directions to test.
 
        python2 setup.py bdist_wheel; python3 setup.py bdist_wheel
 
     to create binary distributions in wheel format. (egg format is
     deprecated.)
 10. Check the roundup.egg-info/SOURCES.txt to make sure that any new files are
     included.  (use hg status --rev <last release or tag>:tip to list changed
-    added and removed files. Last release e.g. 1.5.1 where tip was what would
+    added and removed files. Last release e.g. 1.5.1 where tip is what would
     become 1.6) E.G.
 
-      hg status --rev 1.6.0:tip | sed -ne 's/^A //p' | while read i ; \
+      hg status --rev 1.5.1:tip | sed -ne 's/^A //p' | while read i ; \
       do echo $i; grep "$i" roundup.egg-info/SOURCES.txt; done | uniq -c
 
     Anything with a count of 1 is not in the manifest.
@@ -99,8 +123,9 @@ Roundup release checklist:
     Another way to do this is to use twine (pip install twine).
     You need to sign the tarball. This can be done with:
 
+      cd dist
       gpg --detach-sign --armor <filename>.tgz
-
+      
     you should be prompted to use the roundup release key. If not you
     can add  [email protected].
     This will create a file by the name <filename>.tgz.asc. Then
@@ -138,26 +163,7 @@ Roundup release checklist:
       released version (or at least the major non pre-release
       1.x/2.x version).
 
-So, those commands in a nice, cut'n'pasteable form::
-
- find . -name '*.orig' -exec rm {} \;
- find . -name '*.rej' -exec rm {} \;
- find . -name '.#*' -exec rm {} \;
- python setup.py clean --all
- python setup.py build
- python setup.py check --restructuredtext --metadata --strict
- python setup.py build_doc
- cd locale
- make
- cd ..
- python setup.py sdist --quiet
- ## python setup.py bdist_rpm
- # not required for pypi.org since 2017 -> python setup.py register
- python setup.py sdist upload --repository pypi --sign
-
-Note pypi no longer allows uploads of .exe installers such as produced
-by bdist_wininst. Removed directions for producing the binary
-distribution.
+-------------
 
 If you get errors on the upload operation, you may need the following
 ~/.pypirc file as well
@@ -178,4 +184,3 @@ repository: https://test.pypi.org/legacy/
 username: <your username on test.pypi.org here>
 password: <your password here>
 ========
-