pygmt.project: Migrate the 'azimuth' parameter to the new alias system (#4421)

Author: seisman

pygmt/src/project.py

@@ -21,7 +21,6 @@
 
 @fmt_docstring
 @use_alias(
-    A="azimuth",
     F="convention",
     G="generate",
     N="flat_earth",
@@ -37,6 +36,7 @@ def project(  # noqa: PLR0913
     z=None,
     output_type: Literal["pandas", "numpy", "file"] = "pandas",
     outfile: PathLike | None = None,
+    azimuth: float | None = None,
     center: Sequence[float | str] | None = None,
     endpoint: Sequence[float | str] | None = None,
     width: Sequence[float | str] | None = None,
@@ -111,6 +111,7 @@ def project(  # noqa: PLR0913
     Full GMT docs at :gmt-docs:`project.html`.
 
     $aliases
+       - A = azimuth
        - C = center
        - E = endpoint
        - L = length
@@ -126,19 +127,18 @@ def project(  # noqa: PLR0913
         $table_classes.
     $output_type
     $outfile
-
     center
         Set the origin of the projection, in the form of (*cx*, *cy*), in Definitions 1
         or 2. If Definition 3 is used, then (*cx*, *cy*) are the coordinates of a point
         through which the oblique zero meridian (:math:`p = 0`) should pass.
         (*cx*, *cy*) is not required to be 90 degrees from the pole set by ``pole``.
-    azimuth : float or str
-        Define the azimuth of the projection (Definition 1).
-
+    azimuth
+        Set the azimuth of the projection (Definition 1). The azimuth is clockwise from
+        North (the y-axis) regardless of whether spherical or Cartesian coordinate
+        transformation is applied.
     endpoint
         (*bx*, *by*).
         Set the end point of the projection path (Definition 2).
-
     convention : str
         Specify the desired output using any combination of **xyzpqrs**, in
         any order [Default is **xypqrsz**]. Do not space between the letters.
@@ -236,6 +236,7 @@ def project(  # noqa: PLR0913
         column_names = list("rsp")
 
     aliasdict = AliasSystem(
+        A=Alias(azimuth, name="azimuth"),
         C=Alias(center, name="center", sep="/", size=2),
         E=Alias(endpoint, name="endpoint", sep="/", size=2),
         L=Alias(length, name="length", sep="/", size=2, mapping={"limit": "w"}),