fix reST syntax and Sphinx warnings

Pylons · Jul 19, 2016 · 8bf8aba · 8bf8aba
1 parent aec047a
commit 8bf8aba
Show file tree

Hide file tree

Showing 2 changed files with 5 additions and 6 deletions.
diff --git a/docs/scripts.rst b/docs/scripts.rst
@@ -2,8 +2,8 @@ Substance D Command-Line Utilities
 ==================================
 
 Substance D installs a number of helper scripts for performing admin-related
-tasks.  To get full command-line syntax for any script, run it with
-:option:`--help`.
+tasks.  To get full command-line syntax for any script, run it with the
+option ``--help``.
 
 :program:`sd_adduser`
 ---------------------
@@ -28,7 +28,7 @@ job to drain the queue every two minutes:
 :program:`sd_dump`
 ------------------
 
-Dump an object (and its subobjects) to the filesystem.::
+Dump an object (and its subobjects) to the filesystem::
 
     sd_dump [--source=ZODB-PATH] [--dest=FILESYSTEM-PATH] config_uri
     Dumps the object at ZODB-PATH and all of its subobjects to a

diff --git a/substanced/file/__init__.py b/substanced/file/__init__.py
@@ -151,7 +151,7 @@ def __init__(self, stream=None, mimetype=None, title=_BLANK):
 
              On non-Linux systems, successful use of
              :attr:`substanced.file.USE_MAGIC` requires the installation
-             of additional dependencies.  See :ref:`optional_dependencies`.
+             of additional dependencies.  See :ref:`installing_python_magic`.
         """
         self.blob = Blob()
         self.title = title or _BLANK
@@ -196,8 +196,7 @@ def upload(self, stream, mimetype_hint=None):
 
              On non-Linux systems, successful use of
              :attr:`substanced.file.USE_MAGIC` requires the installation
-             of additional dependencies.  See :ref:`optional_dependencies`.
-          
+             of additional dependencies.  See :ref:`installing_python_magic`.
         """
         if not stream:
             stream = io.StringIO()