From 5e88e6e89a2cf5b583670fa5d0b41881f895a711 Mon Sep 17 00:00:00 2001 From: Mike Bayer Date: Mon, 16 May 2022 10:57:51 -0400 Subject: fix most sphinx warnings (1.4) still can't figure out the warnings with some of the older changelog files. this cherry-picks the sphinx fixes from 1.4 and additionally fixes a small number of new issues in the 2.0 docs. However, 2.0 has many more errors to fix, primarily from the removal of the legacy tutorials left behind a lot of labels that need to be re-linked to the new tutorial. Fixes: #7946 Change-Id: Id657ab23008eed0b133fed65b2f9ea75a626215c (cherry picked from commit 9b55a423459236ca8a2ced713c9e93999dd18922) --- lib/sqlalchemy/util/langhelpers.py | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) (limited to 'lib/sqlalchemy/util/langhelpers.py') diff --git a/lib/sqlalchemy/util/langhelpers.py b/lib/sqlalchemy/util/langhelpers.py index e54f33475..a23bee875 100644 --- a/lib/sqlalchemy/util/langhelpers.py +++ b/lib/sqlalchemy/util/langhelpers.py @@ -1225,7 +1225,11 @@ class HasMemoized: self._memoized_keys |= {key} class memoized_attribute(memoized_property[_T]): - """A read-only @property that is only evaluated once.""" + """A read-only @property that is only evaluated once. + + :meta private: + + """ fget: Callable[..., _T] __doc__: Optional[str] @@ -1254,7 +1258,11 @@ class HasMemoized: @classmethod def memoized_instancemethod(cls, fn: _F) -> _F: - """Decorate a method memoize its return value.""" + """Decorate a method memoize its return value. + + :meta private: + + """ def oneshot(self: Any, *args: Any, **kw: Any) -> Any: result = fn(self, *args, **kw) -- cgit v1.2.1