diff --git a/modules/pacman/README.md b/modules/pacman/README.md
new file mode 100644
index 0000000..946a332
--- /dev/null
+++ b/modules/pacman/README.md
@@ -0,0 +1,56 @@
+Pacman
+======
+
+Adds aliases for the pacman package manager.
+
+Also includes optional helper(s).
+
+.zimrc Configuration
+-------------
+  * `zpacman_frontend='helper_here'` Set helper_here to a wrapper if applicable (powerpill, pacmatic, etc).
+  * `zpacman_helper=(aur)` add/remove any helper scripts to be loaded here.
+
+Helpers
+-------
+
+### aur
+
+provides simple AUR helper aliases.
+
+  * `aurb package_name` clone the package from the AUR, build, and install.
+  * `aurd package_name` clone the package from the AUR, but do not build.
+  * `auru` run inside a directory created with `aurb`, this will update, build, and install a package.
+
+Aliases
+-------
+
+### Build
+
+  * `pacb` build package in the current directory, cleanup, and install.
+
+### Install
+
+  * `paci` install, sync, and upgrade packages.
+  * `pacu` install, sync, and upgrade packages (forcibly refresh package list).
+  * `pacU` install packages from pkg file.
+  * `pacd` install all packages in current directory.
+
+### Remove
+
+  * `pacr` remove package and unneeded dependencies.
+  * `pacrm` remove package, unneded dependencies, and configuration files.
+
+### Query
+
+  * `pacq` query package information from remote repository
+  * `pacQ` query package information from local repository
+
+### Search
+
+  * `pacs` search for package in the remote repository
+  * `pacS` search for package in the local repository
+
+### Orphans
+
+  * `pacol` list orphan packages
+  * `pacor` remove all orphan packages
diff --git a/modules/pacman/alias.zsh b/modules/pacman/alias.zsh
index 827f900..957d695 100644
--- a/modules/pacman/alias.zsh
+++ b/modules/pacman/alias.zsh
@@ -78,4 +78,4 @@ alias pacS='pacman -Qs'
 alias pacol='pacman -Qdt'
 
 # remove orphan packages
-alias pacrl='sudo pacman -Rns $(pacman -Qtdq)'
+alias pacor='sudo pacman -Rns $(pacman -Qtdq)'