List common aliases at the end of docstrings

Author: seisman

doc/conf.py

@@ -124,6 +124,7 @@
 # Render the return argument and attribute lists in the same way as the parameter lists.
 napoleon_use_rtype = False
 napoleon_use_ivar = True
+napoleon_custom_sections = [("Common Parameters", "params_style")]
 
 # Options for sphinx-copybutton.
 # Reference: https://sphinx-copybutton.readthedocs.io

pygmt/src/coast.py

@@ -27,14 +27,14 @@ def coast(  # noqa: PLR0913
     borders: int | str | Sequence[int | str] | None = None,
     shorelines: bool | str | Sequence[int | str] = False,
     box: Box | bool = False,
-    projection: str | None = None,
     frame: str | Sequence[str] | bool = False,
+    projection: str | None = None,
     region: Sequence[float | str] | str | None = None,
     verbose: Literal["quiet", "error", "warning", "timing", "info", "compat", "debug"]
     | bool = False,
     panel: int | Sequence[int] | bool = False,
-    transparency: float | None = None,
     perspective: float | Sequence[float] | str | bool = False,
+    transparency: float | None = None,
     **kwargs,
 ):
     r"""
@@ -72,11 +72,7 @@ def coast(  # noqa: PLR0913
 
     Parameters
     ----------
-    $projection
-    $region
-        *Required if this is the first plot command.*
     $area_thresh
-    $frame
     lakes : str or list
         *fill*\ [**+l**\|\ **+r**].
         Set the shade, color, or pattern for lakes and river-lakes. The
@@ -196,10 +192,17 @@ def coast(  # noqa: PLR0913
         to any of the continent codes (e.g. ``"=EU"`` for Europe). Append
         **+p**\ *pen* to draw polygon outlines [Default is no outline] and
         **+g**\ *fill* to fill them [Default is no fill].
+
+    Common Parameters
+    -----------------
+    $frame
+    $projection
+    $region
+        *Required if this is the first plot command.*
+    $verbose
     $panel
     $perspective
     $transparency
-    $verbose
 
     Example
     -------