Fixing more sphinx warnings and errors

doc/security/index.rst

@@ -11,7 +11,7 @@ Security disclosure policy
 
 .. code-block:: text
 
-    -----BEGIN PGP PUBLIC KEY BLOCK----
+    -----BEGIN PGP PUBLIC KEY BLOCK-----
     Version: GnuPG/MacGPG2 v2.0.22 (Darwin)
 
     mQINBFO15mMBEADa3CfQwk5ED9wAQ8fFDku277CegG3U1hVGdcxqKNvucblwoKCb

salt/states/augeas.py

@@ -42,6 +42,7 @@ def __virtual__():
 def change(name, context=None, changes=None, lens=None, **kwargs):
     '''
     .. versionadded:: 2014.1.6
+
     This state replaces :py:func:`~salt.states.augeas.setvalue`.
 
     Issue changes to Augeas, optionally for a specific context, with a

salt/tops/ext_nodes.py

@@ -25,21 +25,20 @@ does.
 
 See (admittedly degenerate and probably not complete) example:
 
+.. code-block:: text
 
-```
-classes:
-  - basepackages
-  - database
-```
+    classes:
+      - basepackages
+      - database
 
-The above essentially is the same as a top.sls containing
+The above essentially is the same as a top.sls containing:
 
-```
-base:
-  '*':
-    - basepackages
-    - database
+.. code-block:: yaml
 
+    base:
+      '*':
+        - basepackages
+        - database
 '''
 
 # Import python libs