--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/src/list.md	Sun Jul 09 20:15:14 2017 +0200
@@ -0,0 +1,49 @@
+dav list
+========
+
+**`dav list [-altepcR] [-u <date>] <url>`**
+
+Lists child resources of the specified collection. Without any options it
+shows only the direct children and hides files beginning with a dot.
+
+Options
+-------
+
+**`-a`** don't hide files whose names begins with a dot `.`
+
+**`-l`** shows additional information for resources
+
+Example:
+
+	--     4.2 KiB  Oct 11  2015  somefile
+
+The first column contains to fields for flags.
+
+1. Field: `d-` indicates a collection
+2. Field: `-c` indicates an encrypted resource
+
+Also encrypted collections are possible, but only the collection name is encrypted, the content may be unencrypted.
+
+The second column in the `list -l` output is the resource size. The number has always a suffix (bytes, KiB, MiB, GiB, TiB). To get the exact content-length in bytes you can use the [dav info][1] command.
+
+[1]: ./info.html
+
+The third column is the date of the last modification. The `strftime` format is `%b %d %H:%M` if the year is the same. Otherwise the format is `%b %d  %Y`.
+
+The last column is the resource name. If the `-R` option is specified, the resource path is shown.
+
+**`-t`** this options only work in combination with `-l` and it adds the resource content type to the output (after the flags)
+
+**`-e`** similar to `-l`, but with 6 flag fields. Currently only the first 4 fields are used. The last two are reserved for future use.
+
+3. Field: **l** indicates a locked resource
+4. Field: **x** indicates a executable resource (executable property with http://apache.org/dav/props/ namespace)
+
+**`-p`** disables file name and path decryption if enabled
+
+**`-c`** enables file name and path decryption
+
+**`-R`** recursively shows all resources in the collection and all child collections
+
+**`-u <date>`** shows only resources with a lastmodified date after the specified
+  date. Uses the http date format