BPython: bug fixes / patches from trackers

(excuse me for not committing earlier)

Patches by Ken Hughes (thanks for all bug fixes!):

1) Setting a scene's MapOld and MapNew values in python does nothing:
bug #2566 submitted by Dominic Agoro-Ombaka (dmao):
https://projects.blender.org/tracker/?func=detail&aid=2566&group_id=9&atid=125
patch #2571:
https://projects.blender.org/tracker/index.php?func=detail&aid=2571&group_id=9&atid=127

2) Calling the file selector after setting the progress bar crashes Blender:
bug #2418 submitted by Alessandro Garosi (brandano):
https://projects.blender.org/tracker/?func=detail&aid=2418&group_id=9&atid=125
patch #2568:
https://projects.blender.org/tracker/index.php?func=detail&aid=2568&group_id=9&atid=127

3) Menus always generate same event when canceled:
bug #2429 submitted by Campbell Barton:
https://projects.blender.org/tracker/?func=detail&aid=2429&group_id=9&atid=125
patch #2579:
https://projects.blender.org/tracker/?func=detail&aid=2579&group_id=9&atid=127

4) Add a vertex to a mesh with groups using a script and then edit that mesh hangs blender:
bug #2211 reported by German Alonso Tamayo (servivo):
https://projects.blender.org/tracker/index.php?func=detail&aid=2211&group_id=9&atid=125
patch #2580
#https://projects.blender.org/tracker/index.php?func=detail&aid=2580&group_id=9&atid=127

About bug #2033, I'm still looking at it, committing a small fix now.

=====

Patches by Campbell Barton (thanks!):

#2482: BGL pydocs fix broken links
https://projects.blender.org/tracker/index.php?func=detail&aid=2482&group_id=9&atid=127

#2426: Large text in Draw.Text and Draw.GetStreingWidth
https://projects.blender.org/tracker/index.php?func=detail&aid=2462&group_id=9&atid=127

#2521: scene.getActiveObject()
https://projects.blender.org/tracker/index.php?func=detail&aid=2521&group_id=9&atid=127

#2523: NMesh.GetNames()
https://projects.blender.org/tracker/index.php?func=detail&aid=2523&group_id=9&atid=127

- docs also updated

source/blender/python/api2_2x/doc/API_intro.py

@@ -39,6 +39,7 @@ The Blender Python API Reference
   - L{Sound}
   - L{Text}
   - L{Text3d} (new)
+     - L{Font} (new)
   - L{Texture}
   - L{Types}
   - L{Window}
@@ -105,13 +106,16 @@ Interaction with users:
 
  Scripts can:
   - simply run and exit;
-  - grab the main input event queue and process (or pass to Blender) selected
-    keyboard, mouse, redraw events;
   - pop messages, menus and small number and text input boxes;
   - draw graphical user interfaces (guis) with OpenGL calls and native
     program buttons, which stay there accepting user input like any other
     Blender window until the user closes them;
+  - attach themselves to a space's event or drawing code (aka space handlers,
+    L{check here<API_related>});
   - make changes to the 3D View (set visible layer(s), view point, etc);
+  - grab the main input event queue and process (or pass to Blender) selected
+    keyboard, mouse, redraw events -- not considered good practice, but still
+    available for private use;
   - tell Blender to execute other scripts (see L{Blender.Run}());
   - use external Python libraries, if available.
 
@@ -206,8 +210,8 @@ A note to newbie script writers:
  to get an idea of what can be done, you may be surprised.
 
 @author: The Blender Python Team
-@requires: Blender 2.36 cvs or newer.
-@version: 2.36 cvs
+@requires: Blender 2.37 or newer.
+@version: 2.37
 @see: U{www.blender3d.org<http://www.blender3d.org>}: main site
 @see: U{www.blender.org<http://www.blender.org>}: documentation and forum
 @see: U{www.elysiun.com<http://www.elysiun.com>}: user forum