docs(trings): fix <blockquote>s happening when they shouldn't

One left in sopel.cli.config, which is better fixed by a small patch to
sphinxcontrib.autoprogram if the patch is accepted.
(See sphinx-contrib/autoprogram#21)

docs/source/cli.rst

@@ -102,10 +102,10 @@ overrides the value from Sopel's config file.
 
 The variable name Sopel looks for is structured as follows:
 
-  * ``SOPEL_`` prefix (to prevent collisions with other programs)
-  * The section name in UPPERCASE, e.g. ``CORE`` or ``PLUGIN_NAME``
-  * ``_`` as separator
-  * The setting name in UPPERCASE, e.g. ``NICK`` or ``API_KEY``
+* ``SOPEL_`` prefix (to prevent collisions with other programs)
+* The section name in UPPERCASE, e.g. ``CORE`` or ``PLUGIN_NAME``
+* ``_`` as separator
+* The setting name in UPPERCASE, e.g. ``NICK`` or ``API_KEY``
 
 For example, take this stripped-down config file:
 

sopel/cli/config.py

@@ -27,6 +27,9 @@ def build_parser():
     list_parser = subparsers.add_parser(
         'list',
         help="List available configurations from Sopel's config directory",
+        # TODO: if https://github.com/sphinx-contrib/autoprogram/pull/21 is
+        # accepted, we'll need to require a version of autoprogram including
+        # the fix. (If not... we need an alternative solution locally.)
         description="""
             List available configurations from Sopel's config directory
             with the extension "{ext}". Use option ``--config-dir`` to use a

sopel/config/__init__.py

@@ -198,15 +198,15 @@ def add_section(self, name):
 
             The section's ``name`` SHOULD follow *snake_case* naming rules:
 
-              * use only lowercase letters, digits, and underscore (``_``)
-              * SHOULD NOT start with a digit
+            * use only lowercase letters, digits, and underscore (``_``)
+            * SHOULD NOT start with a digit
 
             Deviations from *snake_case* can break the following operations:
 
-              * :ref:`accessing the section <sopel.config>` from Python code using
-                the :class:`~.Config` object's attributes
-              * :ref:`overriding the section's values <Overriding individual
-                settings>` using environment variables
+            * :ref:`accessing the section <sopel.config>` from Python code
+              using the :class:`~.Config` object's attributes
+            * :ref:`overriding the section's values <Overriding individual
+              settings>` using environment variables
 
         """
         try:
@@ -235,15 +235,15 @@ def define_section(self, name, cls_, validate=True):
 
             The section's ``name`` SHOULD follow *snake_case* naming rules:
 
-              * use only lowercase letters, digits, and underscore (``_``)
-              * SHOULD NOT start with a digit
+            * use only lowercase letters, digits, and underscore (``_``)
+            * SHOULD NOT start with a digit
 
             Deviations from *snake_case* can break the following operations:
 
-              * :ref:`accessing the section <sopel.config>` from Python code using
-                the :class:`~.Config` object's attributes
-              * :ref:`overriding the section's values <Overriding individual
-                settings>` using environment variables
+            * :ref:`accessing the section <sopel.config>` from Python code
+              using the :class:`~.Config` object's attributes
+            * :ref:`overriding the section's values <Overriding individual
+              settings>` using environment variables
 
         """
         if not issubclass(cls_, types.StaticSection):

sopel/config/types.py

@@ -138,15 +138,15 @@ class BaseValidated(object):
 
         Setting names SHOULD follow *snake_case* naming rules:
 
-          * use only lowercase letters, digits, and underscore (``_``)
-          * SHOULD NOT start with a digit
+        * use only lowercase letters, digits, and underscore (``_``)
+        * SHOULD NOT start with a digit
 
         Deviations from *snake_case* can break the following operations:
 
-          * :ref:`accessing the setting <sopel.config>` from Python code using
-            the :class:`~.Config` object's attributes
-          * :ref:`overriding the setting's value <Overriding individual
-            settings>` using environment variables
+        * :ref:`accessing the setting <sopel.config>` from Python code using
+          the :class:`~.Config` object's attributes
+        * :ref:`overriding the setting's value <Overriding individual
+          settings>` using environment variables
 
     """
     def __init__(self, name, default=None, is_secret=False):

sopel/tools/web.py

@@ -215,8 +215,8 @@ def trim_url(url):
     This function removes trailing punctuation that looks like it was not
     intended to be part of the URL:
 
-        * trailing sentence- or clause-ending marks like ``.``, ``;``, etc.
-        * unmatched trailing brackets/braces like ``}``, ``)``, etc.
+    * trailing sentence- or clause-ending marks like ``.``, ``;``, etc.
+    * unmatched trailing brackets/braces like ``}``, ``)``, etc.
 
     It is intended for use with the output of :py:func:`~.search_urls`, which
     may include trailing punctuation when used on input from chat.