update docstring requirements

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