1 files changed, 29 insertions, 0 deletions

diff --git a/docs/luarocks_search.md b/docs/luarocks_search.md
new file mode 100644
index 00000000..70cea427
--- /dev/null
+++ b/docs/luarocks_search.md
@@ -0,0 +1,29 @@
+# luarocks search
+
+Query the LuaRocks servers.
+
+## Usage
+
+`luarocks search [--porcelain] [--source] [--binary] { <query> [<version>] | --all }`
+
+Lists files available on LuaRocks servers. `<query>` is a substring of a rock
+name to filter by. The search can be narrowed further narrowed down using a
+version. To list files for all rocks pass `--all`.
+
+If `--porcelain` is passed, machine-friendly output is produced.
+
+If `--source` is passed, only rockspecs and source rocks are shown.
+
+If `--binary` is passed, only binary and pure-Lua rocks are shown.
+
+Rocks not supporting version of Lua used by LuaRocks are not listed.
+
+The `luarocks search` command queries remote repositories.
+To query your local repository (the rocks you have installed), use [luarocks list](luarocks_list.md).
+
+## Example
+
+```
+luarocks search socket
+```
+