Move description for -l common option to pygmt/helpers/decorators.py (#1408)

* Move label description to COMMON OPTIONS

* Add link to full -l docs

Co-authored-by: Dongdong Tian <[email protected]>
Co-authored-by: Michael Grund <[email protected]>

Author: 3 people

pygmt/helpers/decorators.py

@@ -163,6 +163,10 @@
             (:gmt-term:`PROJ_MEAN_RADIUS`), and the specification of latitude type
             (:gmt-term:`PROJ_AUX_LATITUDE`). Geodesic distance calculations is also
             controlled by method (:gmt-term:`PROJ_GEODESIC`).""",
+    "l": r"""
+        label : str
+            Add a legend entry for the symbol or line being plotted. Full
+            documentation is at :gmt-docs:`gmt.html#l-full`.""",
     "n": r"""
         interpolation : str
             [**b**\|\ **c**\|\ **l**\|\ **n**][**+a**][**+b**\ *BC*][**+c**][**+t**\ *threshold*].

pygmt/src/histogram.py

@@ -119,8 +119,7 @@ def histogram(self, table, **kwargs):
     {XY}
     {U}
     {V}
-    label : str
-        Add a legend entry for the symbol or line being plotted.
+    {l}
     {p}
     {t}
     """

pygmt/src/plot.py

@@ -194,9 +194,7 @@ def plot(self, x=None, y=None, data=None, size=None, direction=None, **kwargs):
     {c}
     {f}
     {i}
-    label : str
-        Add a legend entry for the symbol or line being plotted.
-
+    {l}
     {p}
     {t}
         *transparency* can also be a 1d array to set varying transparency

pygmt/src/plot3d.py

@@ -164,8 +164,7 @@ def plot3d(
     {c}
     {f}
     {i}
-    label : str
-        Add a legend entry for the symbol or line being plotted.
+    {l}
     {p}
     {t}
         *transparency* can also be a 1d array to set varying transparency