Apply suggestions from code review

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

pygmt/src/makecpt.py

@@ -49,7 +49,7 @@ def makecpt(**kwargs):
  the new master file. If not, the parameters :gmt-term:`COLOR_BACKGROUND`,
  :gmt-term:`COLOR_FOREGROUND`, and :gmt-term:`COLOR_NAN` from the
  :gmt-docs:`gmt.conf <gmt.conf>` file or the command line will be used. This
- default behavior can be overruled using the options ``background``,
+ default behavior can be overruled using the parameters ``background``,
  ``overrule_bg`` or ``no_bg``.
 
  The color model (RGB, HSV or CMYK) of the palette created by **makecpt**
@@ -81,7 +81,7 @@ def makecpt(**kwargs):
  ``background='i'`` to match the colors for the lowest and highest
  values in the input (instead of the output) CPT.
  color_model :
- [**R**\|\ **r**\|\ **h**\|\ **c**\ ][**+c**\ [*label*\ ]].
+ [**R**\|\ **r**\|\ **h**\|\ **c**][**+c**\ [*label*]].
  Force output CPT to be written with r/g/b codes, gray-scale values or
  color name (**R**, default) or r/g/b codes only (**r**), or h-s-v codes
  (**h**), or c/m/y/k codes (**c**). Optionally or alternatively, append
@@ -90,10 +90,10 @@ def makecpt(**kwargs):
  CPT is plotted. The *label* may be a comma-separated list of category
  names (you can skip a category by not giving a name), or give
  *start*[-], where we automatically build monotonically increasing
- labels from *start*\ (a single letter or an integer). Append - to build
+ labels from *start* (a single letter or an integer). Append - to build
  ranges *start*-*start+1* instead.
  series : list or str
- [*min/max/inc*\ [**+b**\|\ **l**\|\ **n**\ ]\|\ *file*\|\ *list*\ ].
+ [*min/max/inc*\[**+b**\|\ **l**\|\ **n**]\|\ *file*\|\ *list*].
  Defines the range of the new CPT by giving the lowest and highest
  z-value (and optionally an interval). If this is not given, the
  existing range in the master CPT will be used intact. The values
@@ -102,9 +102,9 @@ def makecpt(**kwargs):
  For details on array creation, see
  :gmt-docs:`makecpt.html#generate-1d-array`.
  truncate : list or str
- *zlo/zhi*\ .
+ *zlow/zhigh*.
  Truncate the incoming CPT so that the lowest and highest z-levels are
- to *zlo* and *zhi*. If one of these equal NaN then we leave that end of
+ to *zlow* and *zhigh*. If one of these equal NaN then we leave that end of
  the CPT alone. The truncation takes place before any resampling. See
  also :gmt-docs:`cookbook/features.html#manipulating-cpts`.
  output : str

pygmt/src/surface.py

@@ -47,12 +47,12 @@ def surface(x=None, y=None, z=None, data=None, **kwargs):
  Either a data file name or a 2d numpy array with the tabular data.
 
  spacing : str
- *xinc*\[\ *unit*\][**+e**\|\ **n**]
+ *xinc*\[\ *unit*\][**+e**\|\ **n**]\
  [/*yinc*\ [*unit*][**+e**\|\ **n**]].
  *xinc* [and optionally *yinc*] is the grid spacing.
 
  region : str or list
- *xmin/xmax/ymin/ymax*\[\ **+r**\][**+u**\ *unit*].
+ *xmin/xmax/ymin/ymax*\[**+r**][**+u**\ *unit*].
  Specify the region of interest.
 
  outfile : str

pygmt/x2sys.py

@@ -120,7 +120,7 @@ def x2sys_init(tag, **kwargs):
  [Default]). If not given we assume the data are Cartesian.
 
  spacing : str or list
- *dx*\[/*dy*\].
+ *dx*\[/*dy*].
  *dx* [and optionally *dy*] is the grid spacing. Append **m** to
  indicate minutes or **s** to indicate seconds for geographic data.
  These spacings refer to the binning used in the track bin-index data