Make example commands multiline

Author: ConorMacBride

docs/summaries.rst

@@ -30,63 +30,90 @@ summary can also be saved. Multiple options can be specified comma-separated.
 
     .. code-block:: bash
 
-        pytest --mpl --mpl-results-path=results --mpl-generate-summary=html,json
+        pytest --mpl \
+          --mpl-results-path=results \
+          --mpl-generate-summary=html,json
 
     :summary:`test_html_images_only`
 
 .. card:: Hash comparison only
 
     .. code-block:: bash
 
-        pytest --mpl --mpl-hash-library=mpl35_ft261.json --mpl-results-path=results --mpl-generate-summary=html,json
+        pytest --mpl \
+          --mpl-hash-library=mpl35_ft261.json \
+          --mpl-results-path=results \
+          --mpl-generate-summary=html,json
 
     :summary:`test_html_hashes_only`
 
 .. card:: Hybrid mode: hash and image comparison
 
     .. code-block:: bash
 
-        pytest --mpl --mpl-hash-library=mpl35_ft261.json --mpl-baseline-path=baseline --mpl-results-path=results --mpl-generate-summary=html,json
+        pytest --mpl \
+          --mpl-hash-library=mpl35_ft261.json \
+          --mpl-baseline-path=baseline \
+          --mpl-results-path=results \
+          --mpl-generate-summary=html,json
 
     :summary:`test_html`
 
 .. card:: Generating baseline images and hashes (With no testing)
 
     .. code-block:: bash
 
-        pytest --mpl --mpl-generate-path=baseline --mpl-generate-hash-library=test_hashes.json --mpl-results-path=results --mpl-generate-summary=html,json
+        pytest --mpl \
+          --mpl-generate-path=baseline \
+          --mpl-generate-hash-library=test_hashes.json \
+          --mpl-results-path=results \
+          --mpl-generate-summary=html,json
 
     :summary:`test_html_generate`
 
 .. card:: Generating baseline images (With no testing)
 
     .. code-block:: bash
 
-        pytest --mpl --mpl-generate-path=baseline --mpl-results-path=results --mpl-generate-summary=html,json
+        pytest --mpl \
+          --mpl-generate-path=baseline \
+          --mpl-results-path=results \
+          --mpl-generate-summary=html,json
 
     :summary:`test_html_generate_images_only`
 
 .. card:: Generating baseline hashes (With image comparison)
 
     .. code-block:: bash
 
-        pytest --mpl --mpl-generate-hash-library=test_hashes.json --mpl-results-path=results --mpl-generate-summary=html,json
+        pytest --mpl \
+          --mpl-generate-hash-library=test_hashes.json \
+          --mpl-results-path=results \
+          --mpl-generate-summary=html,json
 
     :summary:`test_html_generate_hashes_only`
 
 .. card:: Generating baseline hashes (With hash comparison)
 
     .. code-block:: bash
 
-        pytest --mpl --mpl-generate-hash-library=test_hashes.json --mpl-hash-library=mpl35_ft261.json --mpl-results-path=results --mpl-generate-summary=html,json
+        pytest --mpl \
+          --mpl-generate-hash-library=test_hashes.json \
+          --mpl-hash-library=mpl35_ft261.json \
+          --mpl-results-path=results \
+          --mpl-generate-summary=html,json
 
     :summary:`test_html_run_generate_hashes_only`
 
 .. card:: Hybrid mode: hash and image comparison
 
     .. code-block:: bash
 
-        pytest --mpl --mpl-hash-library=mpl35_ft261.json --mpl-baseline-path=baseline --mpl-results-path=results --mpl-generate-summary=basic-html,json
+        pytest --mpl \
+          --mpl-hash-library=mpl35_ft261.json \
+          --mpl-baseline-path=baseline \
+          --mpl-results-path=results \
+          --mpl-generate-summary=basic-html,json
 
     :summary:`test_basic_html`