Merge pull request #341 from lsst-sqre/tickets/DM-47789

DM-47789: Make pagination docs friendlier to subclasses

Author: rra

safir/src/safir/database/_pagination.py

@@ -113,10 +113,10 @@ def from_entry(cls, entry: E, *, reverse: bool = False) -> Self:
 
         Builds a cursor to get the entries after the provided entry, or before
         the provided entry if ``reverse`` is set to `True`. When the cursor is
-        later applied with `apply_cursor`, forward cursors (the default) must
-        include the entry the cursor was based on. Reverse cursors must
-        exclude the given entry and return data starting with the entry
-        immediately previous.
+        later applied with `~safir.database.PaginationCursor.apply_cursor`,
+        forward cursors (the default) must include the entry the cursor was
+        based on. Reverse cursors must exclude the given entry and return data
+        starting with the entry immediately previous.
 
         Parameters
         ----------
@@ -127,7 +127,7 @@ def from_entry(cls, entry: E, *, reverse: bool = False) -> Self:
 
         Returns
         -------
-        PaginationCursor
+        safir.database.PaginationCursor
             Requested cursor.
         """
 
@@ -148,7 +148,7 @@ def from_str(cls, cursor: str) -> Self:
 
         Raises
         ------
-        InvalidCursorError
+        safir.database.InvalidCursorError
             Raised if the cursor is invalid.
         """