tweak doc

sagemath · Sep 8, 2022 · e08cd7a · e08cd7a
1 parent 9ec90c5
commit e08cd7a
Showing 1 changed file with 3 additions and 3 deletions.
diff --git a/src/sage/categories/monoids.py b/src/sage/categories/monoids.py
@@ -374,15 +374,15 @@ def inverse(self):
             """
             Return the inverse of ``self``.
 
-            This is an alias for inversion, defined in ``__invert__``.
-
-            Element classes should implement ``__invert__`` only.
+            This is an alias for inversion, which can also be invoked
+            by ``~x`` for an element ``x``.
 
             EXAMPLES::
 
                 sage: AA(sqrt(~2)).inverse()
                 1.414213562373095?
             """
+            # Nota Bene: Element classes should implement ``__invert__`` only.
             return self.__invert__()
 
     class Commutative(CategoryWithAxiom):