diff --git a/sphinx_doc_src/cmds/prompt_pwd.rst b/sphinx_doc_src/cmds/prompt_pwd.rst
index 0ee7a0ea4..9845c01fd 100644
--- a/sphinx_doc_src/cmds/prompt_pwd.rst
+++ b/sphinx_doc_src/cmds/prompt_pwd.rst
@@ -12,9 +12,9 @@ prompt_pwd
 Description
 -----------
 
-prompt_pwd is a function to print the current working directory in a way suitable for prompts. It will replace the home directory with "~" and shorten every path component but the last to a default of one character.
+``prompt_pwd`` is a function to print the current working directory in a way suitable for prompts. It will replace the home directory with "~" and shorten every path component but the last to a default of one character.
 
-To change the number of characters per path component, set $fish_prompt_pwd_dir_length to the number of characters. Setting it to 0 or an invalid value will disable shortening entirely.
+To change the number of characters per path component, set ``$fish_prompt_pwd_dir_length`` to the number of characters. Setting it to 0 or an invalid value will disable shortening entirely.
 
 Examples
 --------
diff --git a/sphinx_doc_src/cmds/suspend.rst b/sphinx_doc_src/cmds/suspend.rst
index 5c8c69a47..c43c9d3c2 100644
--- a/sphinx_doc_src/cmds/suspend.rst
+++ b/sphinx_doc_src/cmds/suspend.rst
@@ -12,9 +12,4 @@ suspend [--force]
 Description
 -----------
 
-``suspend`` suspends execution of the current shell by sending it a
-SIGTSTP signal, returning to the controlling process. It can be
-resumed later by sending it a SIGCONT.  In order to prevent suspending
-a shell that doesn't have a controlling process, it will not suspend
-the shell if it is a login shell. This requirement is bypassed
-if the ``--force`` option is given or the shell is not interactive.
\ No newline at end of file
+``suspend`` suspends execution of the current shell by sending it a SIGTSTP signal, returning to the controlling process. It can be resumed later by sending it a SIGCONT.  In order to prevent suspending a shell that doesn't have a controlling process, it will not suspend the shell if it is a login shell. This requirement is bypassed if the ``--force`` option is given or the shell is not interactive.