Merge pull request #624 from Cdiaz1234/fix-docs-shiftdata

Fix incorrect docstring return order in shiftdata()

Author: molinav

CHANGELOG.md

@@ -67,6 +67,8 @@ https://semver.org/spec/v2.0.0.html
 
 ### Fixed
 - Fix Cython extension to use `noexcept` (PR [#615] by @cvanelteren).
+- Fix incorrect return order described in `Basemap.shiftdata` docstring
+  (PR [#624] by @Cdiaz1234, solves issue [#599]).
 
 ### Removed
 - Deprecated `bdist_wheel.universal` option when building wheels.
@@ -1157,6 +1159,8 @@ https://semver.org/spec/v2.0.0.html
 - Fix glitches in drawing of parallels and meridians.
 
 
+[#624]:
+https://github.com/matplotlib/basemap/pull/624
 [#623]:
 https://github.com/matplotlib/basemap/pull/623
 [#622]:
@@ -1177,6 +1181,8 @@ https://github.com/matplotlib/basemap/pull/614
 https://github.com/matplotlib/basemap/issues/608
 [#604]:
 https://github.com/matplotlib/basemap/issues/604
+[#599]:
+https://github.com/matplotlib/basemap/issues/599
 [#598]:
 https://github.com/matplotlib/basemap/pull/598
 [#595]:

packages/basemap/src/mpl_toolkits/basemap/__init__.py

@@ -4836,10 +4836,11 @@ def shiftdata(self,lonsin,datain=None,lon_0=None,fix_wrap_around=True):
                          [lon_0-180, lon_0+180] range.
         ================ ======================================================
 
-        if datain given, returns ``dataout,lonsout`` (data and longitudes shifted to fit in interval
-        [lon_0-180,lon_0+180]), otherwise just returns longitudes.  If
-        transformed longitudes lie outside map projection region, data is
-        masked and longitudes are set to 1.e30.
+        If datain is given, returns ``lonsout, dataout`` (longitudes and data
+        shifted to fit in the interval [lon_0-180, lon_0+180]); otherwise,
+        returns just the shifted longitudes. If transformed longitudes lie
+        outside the map projection region, data is masked and longitudes are
+        set to 1.e30.
         """
         if lon_0 is None and 'lon_0' not in self.projparams:
             raise ValueError('lon_0 keyword must be provided')