CSS changes to the API reference (#5609)

CSS changes to the API reference

CHANGELOG.rst

@@ -1,6 +1,6 @@
-=================
+=========
-Changelog history
+Changelog
-=================
+=========
 
 Versions follow `Semantic Versioning <https://semver.org/>`_ (``<major>.<minor>.<patch>``).
 

doc/en/_templates/globaltoc.html

@@ -4,7 +4,7 @@
   <li><a href="{{ pathto('index') }}">Home</a></li>
   <li><a href="{{ pathto('getting-started') }}">Install</a></li>
   <li><a href="{{ pathto('contents') }}">Contents</a></li>
-  <li><a href="{{ pathto('reference') }}">Reference</a></li>
+  <li><a href="{{ pathto('reference') }}">API Reference</a></li>
   <li><a href="{{ pathto('example/index') }}">Examples</a></li>
   <li><a href="{{ pathto('customize') }}">Customize</a></li>
   <li><a href="{{ pathto('changelog') }}">Changelog</a></li>

doc/en/_themes/flask/static/flasky.css_t

@@ -424,12 +424,56 @@ a:hover tt {
     background: #EEE;
 }
 
+#reference div.section h2 {
+    /* separate code elements in the reference section */
+    border-top: 2px solid #ccc;
+    padding-top: 0.5em;
+}
+
 #reference div.section h3 {
     /* separate code elements in the reference section */
     border-top: 1px solid #ccc;
     padding-top: 0.5em;
 }
 
+dl.class, dl.function {
+    margin-top: 1em;
+    margin-bottom: 1em;
+}
+
+dl.class > dd {
+    border-left: 3px solid #ccc;
+    margin-left: 0px;
+    padding-left: 30px;
+}
+
+dl.field-list {
+    flex-direction: column;
+}
+
+dl.field-list dd {
+    padding-left: 4em;
+    border-left: 3px solid #ccc;
+    margin-bottom: 0.5em;
+}
+
+dl.field-list dd > ul {
+    list-style: none;
+    padding-left: 0px;
+}
+
+dl.field-list dd > ul > li li :first-child {
+    text-indent: 0;
+}
+
+dl.field-list dd > ul > li :first-child {
+    text-indent: -2em;
+    padding-left: 0px;
+}
+
+dl.field-list dd > p:first-child {
+    text-indent: -2em;
+}
 
 @media screen and (max-width: 870px) {
 

doc/en/reference.rst

@@ -1,5 +1,5 @@
-Reference
+API Reference
-=========
+=============
 
 This page contains the full reference to pytest's API.
 

src/_pytest/mark/structures.py

@@ -193,17 +193,18 @@ class MarkDecorator:
             pass
 
     When a MarkDecorator instance is called it does the following:
-      1. If called with a single class as its only positional argument and no
+
-         additional keyword arguments, it attaches itself to the class so it
+    1. If called with a single class as its only positional argument and no
-         gets applied automatically to all test cases found in that class.
+       additional keyword arguments, it attaches itself to the class so it
-      2. If called with a single function as its only positional argument and
+       gets applied automatically to all test cases found in that class.
-         no additional keyword arguments, it attaches a MarkInfo object to the
+    2. If called with a single function as its only positional argument and
-         function, containing all the arguments already stored internally in
+       no additional keyword arguments, it attaches a MarkInfo object to the
-         the MarkDecorator.
+       function, containing all the arguments already stored internally in
-      3. When called in any other case, it performs a 'fake construction' call,
+       the MarkDecorator.
-         i.e. it returns a new MarkDecorator instance with the original
+    3. When called in any other case, it performs a 'fake construction' call,
-         MarkDecorator's content updated with the arguments passed to this
+       i.e. it returns a new MarkDecorator instance with the original
-         call.
+       MarkDecorator's content updated with the arguments passed to this
+       call.
 
     Note: The rules above prevent MarkDecorator objects from storing only a
     single function or class reference as their positional argument with no

src/_pytest/python_api.py

@@ -542,7 +542,7 @@ def raises(expected_exception, *args, **kwargs):
         string that may contain `special characters`__, the pattern can
         first be escaped with ``re.escape``.
 
-    __ https://docs.python.org/3/library/re.html#regular-expression-syntax
+        __ https://docs.python.org/3/library/re.html#regular-expression-syntax
 
     :kwparam message: **(deprecated since 4.1)** if specified, provides a custom failure message
         if the exception is not raised. See :ref:`the deprecation docs <raises message deprecated>` for a workaround.