Fixes for PDF build errors

salt/roster/clustershell.py

@@ -1,14 +1,15 @@
 # -*- coding: utf-8 -*-
 '''
-:requires: clustershell
-https://github.com/cea-hpc/clustershell
-
 This roster resolves hostname in a pdsh/clustershell style.
 
-When you want to use host globs for target matching, use --roster clustershell.
+:depends: clustershell, https://github.com/cea-hpc/clustershell
+
+When you want to use host globs for target matching, use ``--roster clustershell``. For example:
+
+.. code-block:: bash
 
-Example:
     salt-ssh --roster clustershell 'server_[1-10,21-30],test_server[5,7,9]' test.ping
+
 '''
 
 # Import python libs

salt/runners/nacl.py

@@ -1,25 +1,28 @@
 # -*- coding: utf-8 -*-
 '''
-:requires: libnacl
-https://github.com/saltstack/libnacl
-
 This runner helps create encrypted passwords that can be included in pillars.
-This is often usefull if you wish to store your pillars in source control or
+
+:depends: libnacl, https://github.com/saltstack/libnacl
+
+This is often useful if you wish to store your pillars in source control or
 share your pillar data with others that you trust. I dont advise making your pillars public
 regardless if they are encrypted or not.
 
 The following configurations can be defined in the master config
-so your users can create encrypted passwords using the runner nacl::
+so your users can create encrypted passwords using the runner nacl:
+
+.. code-block:: bash
 
     cat /etc/salt/master.d/nacl.conf
     nacl.config:
         key: None
         keyfile: /root/.nacl
 
-Now with the config in the master you can use the runner nacl like::
+Now with the config in the master you can use the runner nacl like:
+
+.. code-block:: bash
 
     salt-run nacl.enc 'data'
-
 '''
 
 from __future__ import absolute_import