From 02858eb5f916d3071ab2b104e41e4e8251896efb Mon Sep 17 00:00:00 2001
From: Meghan Jones <meghanj@hawaii.edu>
Date: Sun, 14 Feb 2021 09:56:37 -0500
Subject: [PATCH] Add alias annotation (A) to Figure.contour() (#883)

---
 pygmt/src/contour.py | 29 +++++++++++++++--------------
 1 file changed, 15 insertions(+), 14 deletions(-)

diff --git a/pygmt/src/contour.py b/pygmt/src/contour.py
index a782d8d814b..33fe31cd964 100644
--- a/pygmt/src/contour.py
+++ b/pygmt/src/contour.py
@@ -16,27 +16,28 @@
 
 @fmt_docstring
 @use_alias(
-    R="region",
-    J="projection",
+    A="annotation",
     B="frame",
-    S="skip",
+    C="levels",
     G="label_placement",
-    W="pen",
+    J="projection",
     L="triangular_mesh_pen",
     N="no_clip",
-    i="columns",
-    l="label",
-    C="levels",
+    R="region",
+    S="skip",
     V="verbose",
+    W="pen",
     X="xshift",
     Y="yshift",
     c="panel",
+    i="columns",
+    l="label",
     p="perspective",
     t="transparency",
 )
 @kwargs_to_strings(R="sequence", c="sequence_comma", i="sequence_comma", p="sequence")
 def contour(self, x=None, y=None, z=None, data=None, **kwargs):
-    """
+    r"""
     Contour table data by direct triangulation.
 
     Takes a matrix, (x,y,z) pairs, or a file name as input and plots lines,
@@ -44,8 +45,6 @@ def contour(self, x=None, y=None, z=None, data=None, **kwargs):
 
     Must provide either *data* or *x*, *y*, and *z*.
 
-    [TODO: Insert more documentation]
-
     Full option list at :gmt-docs:`contour.html`
 
     {aliases}
@@ -58,10 +57,12 @@ def contour(self, x=None, y=None, z=None, data=None, **kwargs):
         Either a data file name or a 2d numpy array with the tabular data.
     {J}
     {R}
-    A : bool or str
-        ``'[m|p|x|y]'``
-        By default, geographic line segments are drawn as great circle
-        arcs. To draw them as straight lines, use *A*.
+    annotation : str or int
+        Specify or disable annotated contour levels, modifies annotated
+        contours specified in ``interval``.
+
+        - Specify a fixed annotation interval *annot_int* or a
+          single annotation level +\ *annot_int*.
     {B}
     levels : str
         Contour file or level(s)