Improve memoize docs

grantjenks · grantjenks · commit ef087b93e98f · 2019-06-25T10:01:09.000-07:00
diff --git a/docs/tutorial.rst b/docs/tutorial.rst
@@ -372,9 +372,9 @@ a one second timeout. Operations will attempt to abort if they take longer than
 one second. The remaining API of :class:`FanoutCache <diskcache.FanoutCache>`
 matches :class:`Cache <diskcache.Cache>` as described above.
 
-:class:`FanoutCache <diskcache.FanoutCache>` adds an additional feature:
-:meth:`memoizing <diskcache.FanoutCache.memoize>` cache decorator. The
-decorator wraps a callable and caches arguments and return values.
+Caches have an additional feature: :meth:`memoizing
+<diskcache.FanoutCache.memoize>` decorator. The decorator wraps a callable and
+caches arguments and return values.
 
     >>> from diskcache import FanoutCache
     >>> cache = FanoutCache()
@@ -386,14 +386,14 @@ decorator wraps a callable and caches arguments and return values.
     ...         return 1
     ...     else:
     ...         return fibonacci(number - 1) + fibonacci(number - 2)
-    >>> print(sum(fibonacci(number=value) for value in range(100)))
+    >>> print(sum(fibonacci(value) for value in range(100)))
     573147844013817084100
 
 The arguments to memoize are like those for `functools.lru_cache
 <https://docs.python.org/3/library/functools.html#functools.lru_cache>`_ and
-:meth:`FanoutCache.set <diskcache.FanoutCache.set>`. Remember to call
-:meth:`memoize <diskcache.FanoutCache.memoize>` when decorating a callable. If
-you forget, then a TypeError will occur.
+:meth:`Cache.set <.Cache.set>`. Remember to call :meth:`memoize
+<.FanoutCache.memoize>` when decorating a callable. If you forget, then a
+TypeError will occur::
 
     >>> @cache.memoize
     ... def test():
@@ -403,7 +403,7 @@ you forget, then a TypeError will occur.
     TypeError: name cannot be callable
 
 Observe the lack of parenthenses after :meth:`memoize
-<diskcache.FanoutCache.set>` above.
+<diskcache.FanoutCache.memoize>` above.
 
 .. _`Sharding`: https://en.wikipedia.org/wiki/Shard_(database_architecture)
 
