diff --git a/doc_src/alias.txt b/doc_src/alias.txt
index f02f9d69b..fc36fbbac 100644
--- a/doc_src/alias.txt
+++ b/doc_src/alias.txt
@@ -9,16 +9,14 @@ alias NAME=DEFINITION
\subsection alias-description Description
-`alias` is a simple wrapper for the `function` builtin, which creates a function wrapping a command. It has similar syntax to POSIX sh `alias`. For other uses, it is recommended to define a function.
+`alias` is a simple wrapper for the `function` builtin, which creates a function wrapping a command. It has similar syntax to POSIX shell `alias`. For other uses, it is recommended to define a function.
-`fish` marks functions that have been created by `alias` by including the command used to craete them in the function description. You can list alias-created functions by running `alias` without arguments. They must be erased using `functions -e`.
+`fish` marks functions that have been created by `alias` by including the command used to create them in the function description. You can list `alias`-created functions by running `alias` without arguments. They must be erased using `functions -e`.
- `NAME` is the name of the alias
- `DEFINITION` is the actual command to execute. The string `$argv` will be appended.
-You cannot create an alias to a function with the same name.
-
-Note that spaces need to be escaped in the call to alias just like in the commandline _even inside the quotes_.
+You cannot create an alias to a function with the same name. Note that spaces need to be escaped in the call to `alias` just like at the command line, _even inside quoted parts_.
\subsection alias-example Example