Proofread edits to subplot round 4

Co-Authored-By: Dongdong Tian <seisman.info@gmail.com>

Author: weiji14

examples/tutorials/subplots.py

@@ -207,7 +207,7 @@
     fig.basemap(
         region=[0, 5, 0, 5], projection="X?", frame=["af", "WSne"], panel=[0, 1]
     )
-# Move the plot origin upward by 1 cm
+# Move plot origin by 1 cm above the height of the entire figure
 fig.shift_origin(yshift="h+1c")
 # Top row, one subplot
 with fig.subplot(nrows=1, ncols=1, figsize=("15c", "3c"), autolabel="a)"):
@@ -221,12 +221,12 @@
 ###############################################################################
 #
 # We start by drawing the bottom two subplots, setting ``autolabel="b)"`` so
-# that the subplots are labelled 'b)' and 'c)'. Then, we plot a single subplot
-# on the top row by using ``fig.subplot(..., yshift="h+1c")`` which shifts the
-# plot origin 1 cm above the **h**\ eight of the entire figure that is
-# currently plotted (i.e. the bottom row subplots). You may need to adjust this
-# ``yshift`` parameter to make your plot look nice. This top row uses
-# ``autolabel="a)"``, and we also plotted some text inside. Note that
+# that the subplots are labelled 'b)' and 'c)'. Next, we use
+# :meth:`pygmt.Figure.shift_origin` to move the plot origin 1 cm above the
+# **h**\ eight of the entire figure that is currently plotted (i.e. the bottom
+# row subplots). A single subplot is then plotted on the top row. You may need
+# to adjust the ``yshift`` parameter to make your plot look nice. This top row
+# uses ``autolabel="a)"``, and we also plotted some text inside. Note that
 # ``projection="X?"`` was used to let GMT automatically determine the size of
 # the subplot according to the size of the subplot area.
 

pygmt/src/subplot.py

@@ -67,22 +67,22 @@ def subplot(self, nrows=1, ncols=1, **kwargs):
         Specify automatic tagging of each subplot. Append either a number or
         letter [a]. This sets the tag of the first, top-left subplot and others
         follow sequentially. Surround the number or letter by parentheses on
-        any side if these should be typeset as part of the tag. Use **+j|J**\
-        *refpoint* to specify where the tag should be placed in the subplot
-        [TL]. Note: **+j** sets the justification of the tag to *refpoint*
-        (suitable for interior tags) while **+J** instead selects the mirror
-        opposite (suitable for exterior tags). Append **+c**\ *dx*\[/*dy*] to
-        set the clearance between the tag and a surrounding text box requested
-        via **+g** or **+p** [3p/3p, i.e., 15% of the :gmt-term:`FONT_TAG` size
-        dimension]. Append **+g**\ *fill* to paint the tag's text box with
-        *fill* [no painting]. Append **+o**\ *dx*\ [/*dy*] to offset the tag's
-        reference point in the direction implied by the justification [4p/4p,
-        i.e., 20% of the :gmt-term:`FONT_TAG` size]. Append **+p**\ *pen* to
-        draw the outline of the tag's text box using selected *pen* [no
-        outline]. Append **+r** to typeset your tag numbers using lowercase
-        Roman numerals; use **+R** for uppercase Roman numerals [Arabic
-        numerals]. Append **+v** to increase tag numbers vertically down
-        columns [horizontally across rows].
+        any side if these should be typeset as part of the tag. Use
+        **+j**\|\ **J**\ *refpoint* to specify where the tag should be placed
+        in the subplot [TL]. Note: **+j** sets the justification of the tag to
+        *refpoint* (suitable for interior tags) while **+J** instead selects
+        the mirror opposite (suitable for exterior tags). Append
+        **+c**\ *dx*\[/*dy*] to set the clearance between the tag and a
+        surrounding text box requested via **+g** or **+p** [3p/3p, i.e., 15%
+        of the :gmt-term:`FONT_TAG` size dimension]. Append **+g**\ *fill* to
+        paint the tag's text box with *fill* [no painting]. Append
+        **+o**\ *dx*\ [/*dy*] to offset the tag's reference point in the
+        direction implied by the justification [4p/4p, i.e., 20% of the
+        :gmt-term:`FONT_TAG` size]. Append **+p**\ *pen* to draw the outline of
+        the tag's text box using selected *pen* [no outline]. Append **+r** to
+        typeset your tag numbers using lowercase Roman numerals; use **+R** for
+        uppercase Roman numerals [Arabic numerals]. Append **+v** to increase
+        tag numbers vertically down columns [horizontally across rows].
     {B}
     clearance : str or list
         [*side*]\ *clearance*.