Try another way to add doc

Author: seisman

doc/api/index.rst

@@ -37,6 +37,7 @@ Plotting map elements
     Figure.text
     Figure.timestamp
     Figure.vlines
+    Figure.clip
 
 Plotting tabular data
 ~~~~~~~~~~~~~~~~~~~~~

pygmt/figure.py

@@ -102,8 +102,6 @@ def __init__(self) -> None:
         self._preview_dir = TemporaryDirectory(prefix=f"{self._name}-preview-")
         self._activate_figure()
 
-        self.clip = clip()
-
     def __del__(self) -> None:
         """
         Clean up the temporary directory that stores the previews.
@@ -139,6 +137,17 @@ def region(self) -> np.ndarray:
             wesn = lib.extract_region()
         return wesn
 
+    @property
+    def clip(self) -> clip:
+        """
+        Set up a clipping path.
+
+        - :meth:`pygmt.Figure.clip.land`
+        - :meth:`pygmt.Figure.clip.water`
+        - :meth:`pygmt.Figure.clip.polygon`
+        """
+        return clip()
+
     def savefig(
         self,
         fname: str | PurePath,
@@ -415,7 +424,6 @@ def _repr_html_(self) -> str:
 
     from pygmt.src import (  # type: ignore[misc]
         basemap,
-        clip,
         coast,
         colorbar,
         contour,