1 files changed, 22 insertions, 0 deletions

diff --git a/docs/luarocks_purge.md b/docs/luarocks_purge.md
new file mode 100644
index 00000000..7fda2565
--- /dev/null
+++ b/docs/luarocks_purge.md
@@ -0,0 +1,22 @@
+# luarocks purge
+
+Remove all installed rocks from a tree.
+
+## Usage
+
+`luarocks purge --tree=<tree> [--old-versions]`
+
+Removes all installed rocks from a given tree. The tree must be provided
+explicitly using `--tree`.
+
+If `--old-versions` is passed, the highest version
+of each rock is kept.
+
+## Example
+
+Deleting all rocks from local tree:
+
+```
+luarocks purge --tree=~/.luarocks
+```
+