Merge pull request #5446 from notoraptor/update-release-howto-doc

doc/internal/how_to_release.txt

@@ -64,11 +64,18 @@ The documentation will be automatically regenerated in the next few hours.
 Generate and upload the package
 ===============================
 
-For release candidates, only upload on PyPI.
-
 On PyPI
 -------
 
+Set your umask to ``0022`` to ensure that the package file will be readable from other people.
+To check your umask::
+
+    umask
+
+To set your umask::
+
+    umask 0022
+
 Now change ``ISRELEASED`` in ``setup.py`` to ``True``.
 
 Finally, use setuptools to register and upload the release::
@@ -84,8 +91,8 @@ UnicodeDecodeError if there are non-ASCII characters in NEWS.txt. You
 would need to change NEWS.txt so it contains only ASCII characters (the
 problem usually comes from diacritics in people's names).
 
-On mloss.org
-------------
+On mloss.org (for final releases only)
+--------------------------------------
 
 Project page is at http://mloss.org/software/view/241/.
 Account jaberg is listed as submitter.
@@ -138,8 +145,10 @@ then run the script.
 Announce the release
 ====================
 
-Generate an e-mail from the template in in ``EMAIL.txt``, including content
-from ``NEWS.txt``, and send it to the following mailing lists:
+Generate an e-mail from the template in ``EMAIL.txt``, including content
+from ``NEWS.txt``.
+
+For final releases, send the e-mail to the following mailing lists:
 
 * theano-users
 * theano-announce
@@ -152,3 +161,8 @@ For release candidates, only e-mail:
 * theano-announce
 * theano-dev
 * theano-users
+
+For alpha and beta releases, only e-mail:
+
+* theano-dev
+* theano-users