update docstring requirements

Author: willschlitzer

pygmt/src/basemap.py

@@ -52,9 +52,11 @@ def basemap(self, **kwargs):
     Parameters
     ----------
     {J}
+        *Required if this is the first plot command.*
     zscale/zsize : float or str
         Set z-axis scaling or z-axis size.
     {R}
+        *Required if this is the first plot command.*
     {B}
     map_scale : str
         [**g**\|\ **j**\|\ **J**\|\ **n**\|\ **x**]\ *refpoint*\

pygmt/src/coast.py

@@ -64,7 +64,9 @@ def coast(self, **kwargs):
     Parameters
     ----------
     {J}
+        *Required if this is the first plot command.*
     {R}
+        *Required if this is the first plot command.*
     {A}
     {B}
     lakes : str or list

pygmt/src/histogram.py

@@ -54,7 +54,9 @@ def histogram(self, table, **kwargs):
         Pass in either a file name to an ASCII data table, a Python list, a 2D
         {table-classes}.
     {J}
+        *Required if this is the first plot command.*
     {R}
+        *Required if this is the first plot command.*
     {B}
     {CPT}
     {G}

pygmt/src/solar.py

@@ -50,7 +50,9 @@ def solar(self, terminator="d", terminator_datetime=None, **kwargs):
         passed as a string or Python datetime object.
         [Default is the current UTC date and time]
     {R}
+        *Required if this is the first plot command.*
     {J}
+        *Required if this is the first plot command.*
     {B}
     fill : str
         Color or pattern for filling of terminators.

pygmt/src/text.py

@@ -116,7 +116,9 @@ def text_(
         left. If no justification is explicitly given (i.e. ``justify=True``),
         then the input to ``textfiles`` must have this as a column.
     {J}
+        *Required if this is the first plot command.*
     {R}
+        *Required if this is the first plot command.*
     clearance : str
         [*dx/dy*][**+to**\|\ **O**\|\ **c**\|\ **C**].
         Adjust the clearance between the text and the surrounding box