diff -r 94c0a938b66c -r ee9e63c437c4 docs/src/lock.md
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/src/lock.md	Sun Jul 09 20:15:14 2017 +0200
@@ -0,0 +1,21 @@
+dav lock
+========
+
+**`lock [-pc] <url>`**
+
+Creates a lock on the resource specified by the url. The lock is an exclusive write lock with infinity depth.
+
+If the resource is successfully locked, a lock token for this resource is printed on stdout. This lock token should be saved somewhere to unlock the resource eventually.
+
+**`-p`** disable file name and path decryption if enabled
+
+**`-c`** enable file name and path decryption
+
+### Example 1: lock resource and use the lock token
+
+	$ dav lock myserv/resource
+	opaquelocktoken:0454905e-f2ff-45c4-a3d7-5c4e4db5ce37
+	$ dav put -L opaquelocktoken:0454905e-f2ff-45c4-a3d7-5c4e4db5ce37 myserv/resource newfile
+	$ dav unlock -L opaquelocktoken:0454905e-f2ff-45c4-a3d7-5c4e4db5ce37 myserv/resource
+
+