diff --git a/salt/states/file.py b/salt/states/file.py
index <HASH>..<HASH> 100644
--- a/salt/states/file.py
+++ b/salt/states/file.py
@@ -2205,7 +2205,8 @@ def replace(name,
 
     .. versionadded:: 0.17.0
 
-    Params are identical to :py:func:`~salt.modules.file.replace`.
+    Params are identical to the remote execution function :mod:`file.replace
+    <salt.modules.file.replace>`.
 
     '''
     ret = {'name': name, 'changes': {}, 'result': False, 'comment': ''}
@@ -2389,7 +2390,7 @@ def sed(name,
         negate_match=False):
     '''
     .. deprecated:: 0.17.0
-       Use :py:func:`~salt.states.file.replace` instead.
+       Use the :mod:`file.replace <salt.states.file.replace>` state instead.
 
     Maintain a simple edit to a file
Clarify a couple links in the docs