diff -r ddb5e8f2a43d -r 3070d72f54af docs/src/list.md
--- a/docs/src/list.md	Sat Aug 05 11:33:17 2017 +0200
+++ b/docs/src/list.md	Sat Aug 05 13:35:27 2017 +0200
@@ -3,13 +3,14 @@
 
 **`dav list [-altepcR] [-u <date>] <url>`**
 
-Lists child resources of the specified collection. Without any options it
+Lists child resources of the specified collection. Without any option it
 shows only the direct children and hides files beginning with a dot.
+The behavior is quite similar to that of the unix tool `ls`.
 
 Options
 -------
 
-**`-a`** don't hide files whose names begins with a dot `.`
+**`-a`** don't hide files whose names begin with a dot `.`
 
 **`-l`** show additional information for resources
 
@@ -22,13 +23,13 @@
 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.
+Encrypted collections are also 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 third column is the date of the last modification. The `strftime` format is `%b %d %H:%M` if the year is the current year. 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.
 
@@ -36,8 +37,12 @@
 
 **`-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)
+1. Field: `d---` indicates a collection
+2. Field: `-c--` indicates an encrypted resource
+3. Field: `--l-` indicates a locked resource
+4. Field: `---x` indicates an executable resource (executable property with http://apache.org/dav/props/ namespace)
+
+All combinations of these four flags are possible.
 
 **`-p`** disable file name and path decryption if enabled
 
@@ -45,7 +50,7 @@
 
 **`-R`** recursively show all resources in the collection and all child collections
 
-**`-u <date>`** show only resources with a lastmodified date after the specified
-  date. Uses the http date format
+**`-u <date>`** show only resources with a `lastmodified` date after the specified
+  date. Uses the HTTP date format.
 
 **Command alias:** ls