diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9d3ec7b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,34 @@
+# eselect-ld
+
+
+
+
+## Usage
+
+To set new ld symlink target use
+```
+eselect ld set <TARGET>
+```
+where `TARGET` is either a number from
+```
+eselect ld list
+```
+Alternatively use the name of a linker directly. Name may be
+prefixed by `ld.`.
+```
+eselect ld set mold
+```
+```
+eselect ld set ld.mold
+```
+To print current symlink target use
+```
+eselect ld show
+```
+
+## Installation
+
+Copy into eselect's module directory.
+```
+cp ./ld.eselect /usr/share/eselect/modules/.
+```