diff --git a/doc_src/cmds/alias.rst b/doc_src/cmds/alias.rst
index 5fbb990df..e18af0136 100644
--- a/doc_src/cmds/alias.rst
+++ b/doc_src/cmds/alias.rst
@@ -54,9 +54,11 @@ The following code will create ``rmi``, which runs ``rm`` with additional argume
         rm -i $argv
     end
     
+``alias`` sometimes requires escaping, as you can see here::
+
     # This needs to have the spaces escaped or "Chrome.app..."
     # will be seen as an argument to "/Applications/Google":
-    alias chrome='/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome banana'
+    alias chrome='/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome'
 
 
 See more
diff --git a/doc_src/cmds/wait.rst b/doc_src/cmds/wait.rst
index 7acce74a8..215424655 100644
--- a/doc_src/cmds/wait.rst
+++ b/doc_src/cmds/wait.rst
@@ -46,7 +46,7 @@ spawns ``sleep`` in the background, and then waits until it finishes.
     for i in (seq 1 5); sleep 10 &; end
     wait
 
-spawns five jobs in the background, and then waits until all of them finishes.
+spawns five jobs in the background, and then waits until all of them finish.
 
 
 ::
@@ -55,4 +55,4 @@ spawns five jobs in the background, and then waits until all of them finishes.
     hoge &
     wait sleep
 
-spawns five jobs and ``hoge`` in the background, and then waits until all ``sleep``\s finish, and doesn't wait for ``hoge`` finishing.
+spawns five ``sleep`` jobs and ``hoge`` in the background, and then waits until all ``sleep``\s finish, and doesn't wait for ``hoge``.