From 23abf71e644cbfc3712d6cd1ace51eef9cfc3209 Mon Sep 17 00:00:00 2001 From: Kyle Altendorf Date: Thu, 20 Aug 2020 16:54:32 -0400 Subject: [PATCH] tidy --- docs/source/conf.py | 12 +++++------- docs/source/core.rst | 1 - 2 files changed, 5 insertions(+), 8 deletions(-) diff --git a/docs/source/conf.py b/docs/source/conf.py index 85b6e6e1..10940574 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -20,6 +20,9 @@ import os import sys +import sphinx.locale +import sphinx.util + # So autodoc can import our package sys.path.insert(0, os.path.abspath("../..")) @@ -78,13 +81,8 @@ "undoc-members": True, } -# import inspect -from sphinx.locale import __ -from sphinx.util import logging - -logger = logging.getLogger(__name__) +logger = sphinx.util.logging.getLogger(__name__) -# autodoc_typehints = "none" set_type_checking_flag = True typehints_fully_qualified = False always_document_param_types = False @@ -93,7 +91,7 @@ def warn_undocumented_members(app, what, name, obj, options, lines): if len(lines) == 0: - logger.warning(__(f"{what} {name} is undocumented")) + logger.warning(sphinx.locale.__(f"{what} {name} is undocumented")) lines.append(f".. Warning:: {what} ``{name}`` undocumented") diff --git a/docs/source/core.rst b/docs/source/core.rst index feb983e8..6c9a330f 100644 --- a/docs/source/core.rst +++ b/docs/source/core.rst @@ -20,7 +20,6 @@ emissions. See the :doc:`emissions example ` for an example .. autofunction:: qtrio.enter_emissions_channel .. autoclass:: qtrio.Emission .. autoclass:: qtrio.Emissions - :noindex: If you need a more Qt-like callback mechanism :func:`qtrio.open_emissions_nursery` offers that. Instead of tossing the callbacks behind the couch where they can leave