clean up addcyclic docstring, fix Changelog entry.

Author: Jeff Whitaker

Changelog

@@ -1,8 +1,8 @@
 version 1.0.8 (not yet released)
 --------------------------------
-* don't assume grid is regular with adding cyclic point in addcyclic. 
-  New kwarg 'cyclic' added, with a default of 360.  Partially
-  addresses issue 139.
+* don't assume grid is regular when adding cyclic point in addcyclic. 
+  New kwargs 'axis' and 'cyclic' added.  More than one array
+  can be handled at a time, as long as the last one is longitude. Issue 139.
 * fix for coastline drawing glitch (issue 123).
 * update shapefile.py to version 1.2.0 from pyshp.googlecode.com. Add back
   in modification clobbered in upgrade to version 1.1.7 (issue 30).

lib/mpl_toolkits/basemap/__init__.py

@@ -5089,15 +5089,16 @@ def shiftgrid(lon0,datain,lonsin,start=True,cyclic=360.0):
 
 def addcyclic(*arr,**kwargs):
     """
-    Adds cyclic (wraparound) points in longitude to one or several arrays, 
-    the last array being longitudes in degrees. E.g.
+    Adds cyclic (wraparound) points in longitude to one or several arrays,
+    the last array being longitudes in degrees. e.g.
 
    ``data1out, data2out, lonsout = addcyclic(data1,data2,lons)``
 
     ==============   ====================================================
     Keywords         Description
     ==============   ====================================================
-    axis             the dimension longitude is in (default right-most)
+    axis             the dimension representing longitude (default -1,
+                     or right-most)
     cyclic           width of periodic domain (default 360)
     ==============   ====================================================
     """
@@ -5120,7 +5121,7 @@ def _addcyclic_lon(a):
         # select the right numpy functions
         npsel = np.ma if np.ma.is_masked(a) else np
         # get cyclic longitudes
-        clon = (np.take(a,[0],axis=axis) 
+        clon = (np.take(a,[0],axis=axis)
                 + cyclic * np.sign(np.diff(np.take(a,[0,-1],axis=axis),axis=axis)))
         # ensure the values do not exceed cyclic
         clonmod = npsel.where(clon<=cyclic,clon,np.mod(clon,cyclic))