[docs] [issue24632] Improve documentation about __main__.py

Changes by Ezio Melotti <ezio.melotti@gmail.com>: ---------- nosy: +ncoghlan versions: +Python 3.6 -Python 3.4 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue24632> _______________________________________