DavUtils - cmd tools documentation

# HG changeset patch # User Olaf Wintermann # Date 1502036280 -7200 # Node ID 02d3e4b1245f88b07ac443dece2caab2ee572628 # Parent 8e7ef067594653e29ce2023156d4d9afaae65891 adds some small fixes for 1.0 release diff -r 8e7ef0675946 -r 02d3e4b1245f INSTALL --- a/INSTALL Sun Aug 06 17:02:25 2017 +0200 +++ b/INSTALL Sun Aug 06 18:18:00 2017 +0200 @@ -41,6 +41,7 @@ gcc clang suncc +bsd osx mingw diff -r 8e7ef0675946 -r 02d3e4b1245f LICENSE --- a/LICENSE Sun Aug 06 17:02:25 2017 +0200 +++ b/LICENSE Sun Aug 06 18:18:00 2017 +0200 @@ -1,4 +1,4 @@ -Copyright 2016 Olaf Wintermann. All rights reserved. +Copyright 2017 Olaf Wintermann. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: diff -r 8e7ef0675946 -r 02d3e4b1245f README --- a/README Sun Aug 06 17:02:25 2017 +0200 +++ b/README Sun Aug 06 18:18:00 2017 +0200 @@ -19,7 +19,7 @@ Documentation ------------- -Documentation can be found at http://davutils.sourceforge.net/docs/ and +Documentation can be found at http://davutils.sourceforge.net/docs/dav1/ and in the docs sub-directory. diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/add-directory.html --- a/docs/html/add-directory.html Sun Aug 06 17:02:25 2017 +0200 +++ b/docs/html/add-directory.html Sun Aug 06 18:18:00 2017 +0200 @@ -10,7 +10,7 @@

diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/add-repository.html --- a/docs/html/add-repository.html Sun Aug 06 17:02:25 2017 +0200 +++ b/docs/html/add-repository.html Sun Aug 06 18:18:00 2017 +0200 @@ -10,7 +10,7 @@

diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/check-config.html --- a/docs/html/check-config.html Sun Aug 06 17:02:25 2017 +0200 +++ b/docs/html/check-config.html Sun Aug 06 18:18:00 2017 +0200 @@ -10,7 +10,7 @@

diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/check-repositories.html --- a/docs/html/check-repositories.html Sun Aug 06 17:02:25 2017 +0200 +++ b/docs/html/check-repositories.html Sun Aug 06 18:18:00 2017 +0200 @@ -10,7 +10,7 @@

diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/commands.html --- a/docs/html/commands.html Sun Aug 06 17:02:25 2017 +0200 +++ b/docs/html/commands.html Sun Aug 06 18:18:00 2017 +0200 @@ -10,7 +10,7 @@

diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/configuration.html --- a/docs/html/configuration.html Sun Aug 06 17:02:25 2017 +0200 +++ b/docs/html/configuration.html Sun Aug 06 18:18:00 2017 +0200 @@ -10,7 +10,7 @@

@@ -71,104 +71,75 @@

The config.xml file is an XML file with <configuration> as root element. The <configuration> element can have the following child elements: <repository>, <http-proxy>, <https-proxy>, <key>

repository

This element is used to configure a repository. A repository must have a unique name to identify the repository and a url pointing to the root collection for this repository.

Required child elements: <name>, <url>
-Optional elements: <user>, <password>, <default-key>, <full-encryption>, <content-encryption>, <decrypt-content>, <decrypt-name>, <cert>, <verification>, <ssl-version>, <authmethods>

Required child elements: <name>, <url>
Optional elements: <user>, <password>, <default-key>, <full-encryption>, <content-encryption>, <decrypt-content>, <decrypt-name>, <cert>, <verification>, <ssl-version>, <authmethods>

name

Unique repository identifer.

Type: string
-Example: <name>myrepo</name>

Type: string
Example: <name>myrepo</name>

url

The url must point to a valid WebDAV compilant collection.

Type: url
-Example: <url>https://example.com/webdav/repo1/</url>

Type: url
Example: <url>https://example.com/webdav/repo1/</url>

user

User used for authentication

Type: string
-Example: <user>alice</user>

Type: string
Example: <user>alice</user>

password

A base64 encoded password used for authentication.

Type: base64 string
-Example: <password>MTIzNDU2Nzg=</password>

Type: base64 string
Example: <password>MTIzNDU2Nzg=</password>

default-key

Identifer of the key used by default for encryption. There must be a configured key with this name.

Type: string
-Example: <key>mykey</key>

Type: string
Example: <key>mykey</key>

full-encryption

If this element has the value of true, content and resource name encryption/decryption is enabled. Because encryption and decryption is disabled by default, false has no effect for this element.

Type: boolean
-Default: false
-Example: `true

Type: boolean
Default: false
Example: `true

content-encryption

This element enables only content encryption and decryption. A value of false disables content encryption, but it does not disables content decryption, if this is enabled with <decrypt-content>.

Type: boolean
-Default: false
-Example: <content-encryption>true</content-encryption>

Type: boolean
Default: false
Example: <content-encryption>true</content-encryption>

decrypt-content

Controls only the decryption of content. If true content is decrypted.

Type: boolean
-Default false
-Example: <decrypt-content>true</decrypt-content>

Type: boolean
Default false
Example: <decrypt-content>true</decrypt-content>

decrypt-name

Controls only the decryption of resource names. If true resource names are decrypted. This effects path to url resolution.

Type: boolean
-Default: false
-Example: <decrypt-name>true</decrypt-name>

Type: boolean
Default: false
Example: <decrypt-name>true</decrypt-name>

cert

Path to a file containing certificates to verify the TLS connection to the server.

Type: string
-Example: <cert>/etc/certs/cabundle.pem</cert>

Type: string
Example: <cert>/etc/certs/cabundle.pem</cert>

Note: This element does the same as curl's --cacert option.

verification

This element can disable TLS certificate verification.

Type: boolean
-Default: true
-Example: <verification>false</verification>

Type: boolean
Default: true
Example: <verification>false</verification>

ssl-version

Specifies the SSL version to attempt to use. The value must be one of this strings: TLSv1, TLSv1.0, TLSv1.1, TLSv1.2, SSLv2, SSLv3

Type: ssl version enum
-Example: <ssl-version>TLSv1.2</ssl-version>

Type: ssl version enum
Example: <ssl-version>TLSv1.2</ssl-version>

authmethods

Controls which http authentication methods are used. Multiple methods can be used. The value must be one or more authentication methods separated by space. Valid authentication methods are: basic, digest, negotiate, ntlm, any, none

Type: list of authmethod

Default: basic
-Example: <authmethods>basic digest</authmethods>

Default: basic
Example: <authmethods>basic digest</authmethods>

key

The <key> element configures a key used for encryption. A key must have a unique name, which is stored in the properties of encrypted resources. To decrypt resources, dav looks for configured keys with this name, therefore the name of the key should never changed and must be the same on all hosts accessing the same repository.

Required child elements: <name>, <file>
-Optional elements: <type>

Required child elements: <name>, <file>
Optional elements: <type>

name

Unique key identifer.

Type: string
-Example: <name>key1</name>

Type: string
Example: <name>key1</name>

file

Path to the content of the key. The file should contain 32 (aes256) or 16 (aes128) bytes. If value is not an absolut path, it must be relative to the dav config directory $HOME/.dav/.

Type: string
-Example: <path>keys/key1.bin</path>

Type: string
Example: <path>keys/key1.bin</path>

type

Specifies the key type. Valid values are aes128 or aes256.

Type: aes type enum
-Default: aes256
-Example: <type>aes128</type>

Type: aes type enum
Default: aes256
Example: <type>aes128</type>

http-proxy / https-proxy

Configuration for http and https proxies is the same. Both use the same elements, but https-proxy expects an https url.

Required child elements: <url>
-Optional elements: <user>, <password>, <no>

Required child elements: <url>
Optional elements: <user>, <password>, <no>

url

Specifies the proxy url.

Type: url
-Example: <url>http://myproxy/</url>

Type: url
Example: <url>http://myproxy/</url>

user

User used for authentication with the proxy.

Type: string
-Example: <user>alice</user>

Type: string
Example: <user>alice</user>

password

A base64 encoded password used for authentication.

Type: base64 string
-Example: <password>MTIzNDU2Nzg=</password>

Type: base64 string
Example: <password>MTIzNDU2Nzg=</password>

no

A comma separated list of all hosts that should not be accessed through the proxy.

Type: string
-Example: <no>host1, host2, host3</no>

Type: string
Example: <no>host1, host2, host3</no>

Example 1: minimal repository configuration

A minimal configuration for a repository. If no user and/or password are configured, dav prompts for authentication informations if required.

<configuration>
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/copy.html
--- a/docs/html/copy.html	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/html/copy.html	Sun Aug 06 18:18:00 2017 +0200
@@ -10,7 +10,7 @@
 
 
 
-	davutils documentation
+	DavUtils documentation
 
 
 	
@@ -67,7 +67,7 @@
 
 dav copy
 
-copy [-pcO] [-L <lock>] <url1> <url2>
+dav copy [-pcO] [-L <lock>] <url1> <url2>
 Creates a duplicate of the resource identified by url1 at the location url2. All resource properties are copied. Currently url1 and url2 must be the same host.
 If url1 is a collection, all children are copied.
 If url2 already exists, the command aborts, unless the -O option is specified.
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/date.html
--- a/docs/html/date.html	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/html/date.html	Sun Aug 06 18:18:00 2017 +0200
@@ -10,7 +10,7 @@
 
 
 
-	davutils documentation
+	DavUtils documentation
 
 
 	
@@ -67,7 +67,7 @@
 
 dav date
 
-date [url]
+dav date [url]
 The purpose of this command is to get the current date from a server and print it to stdout (HTTP date format). This in useful in combination with the -u option for the list and get command.
 The url can be any http url. If no url is specified, the local time is used.
 Example: incremental dav get
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/davdoc.css
--- a/docs/html/davdoc.css	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/html/davdoc.css	Sun Aug 06 18:18:00 2017 +0200
@@ -21,6 +21,20 @@
     float: right;
 }
 
+.header a:link {
+	text-decoration: none;
+	color: black;
+}
+
+.header a:visited {
+	text-decoration: none;
+	color: black;
+}
+
+.header a:hover {
+	color: #e68a00;
+}
+
 .sidebar {
     float: left;
     width: 15em;
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/delete-conflicts.html
--- a/docs/html/delete-conflicts.html	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/html/delete-conflicts.html	Sun Aug 06 18:18:00 2017 +0200
@@ -10,7 +10,7 @@
 
 
 
-	davutils documentation
+	DavUtils documentation
 
 
 	
@@ -67,7 +67,7 @@
 
 dav-sync delete-conflicts
 
-delete-conflicts <directory>
+dav-sync delete-conflicts <directory>
 Deletes all files that are marked as a conflict. This will always delete the files and does not move them to the trash directory.
 
 
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/empty-trash.html
--- a/docs/html/empty-trash.html	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/html/empty-trash.html	Sun Aug 06 18:18:00 2017 +0200
@@ -10,7 +10,7 @@
 
 
 
-	davutils documentation
+	DavUtils documentation
 
 
 	
@@ -67,7 +67,7 @@
 
 dav-sync empty-trash
 
-empty-trash <directory>
+dav-sync empty-trash <directory>
 Removes all files from the trash directory of the given sync-directory.
 
 
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/encryption.html
--- a/docs/html/encryption.html	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/html/encryption.html	Sun Aug 06 18:18:00 2017 +0200
@@ -10,7 +10,7 @@
 
 
 
-	davutils documentation
+	DavUtils documentation
 
 
 	
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/get-property.html
--- a/docs/html/get-property.html	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/html/get-property.html	Sun Aug 06 18:18:00 2017 +0200
@@ -10,7 +10,7 @@
 
 
 
-	davutils documentation
+	DavUtils documentation
 
 
 	
@@ -67,7 +67,7 @@
 
 dav get-property
 
-get-property [-pc] [-n <uri>] <url> <property>
+dav get-property [-pc] [-n <uri>] <url> <property>
 Gets a specific resource property. Every WebDAV property has a name and an XML namespace. A namespace can be specified with the -n option or with a prefixed name. The prefix and property name are separated by a : as usual.
 Example: D:creationdate
 D is the prefix, creationdate is the name.
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/get.html
--- a/docs/html/get.html	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/html/get.html	Sun Aug 06 18:18:00 2017 +0200
@@ -10,7 +10,7 @@
 
 
 
-	davutils documentation
+	DavUtils documentation
 
 
 	
@@ -67,7 +67,7 @@
 
 dav get
 
-get [-pcR] [-o <file>] [-u <date>] <url>
+dav get [-pcR] [-o <file>] [-u <date>] <url>
 Downloads a resource. This command also downloads collections and its child resources when the -R option is used. When downloading a single resource, the default local file name is the resource name. When downloading collections, it does not create a local directory with the collection's name and places its children in there, but it downloads the children directly to the current working directory.
 -p disable file name and content decryption. You get exactly what is stored on the server.
 -c enable file name and content decryption
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/getting-started.html
--- a/docs/html/getting-started.html	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/html/getting-started.html	Sun Aug 06 18:18:00 2017 +0200
@@ -10,7 +10,7 @@
 
 
 
-	davutils documentation
+	DavUtils documentation
 
 
 	
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/index.html
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/html/index.html	Sun Aug 06 18:18:00 2017 +0200
@@ -0,0 +1,105 @@
+
+
+
+  
+  
+  
+  DavUtils - cmd tools documentation
+  
+  
+
+
+
+	DavUtils documentation
+
+
+	
+		dav
+			
+				Getting started
+				Commands
+					
+						list
+						get
+						put
+						mkdir
+						remove
+						copy
+						move
+						get-property
+						set-property
+						lock
+						unlock
+						info
+						date
+						add-repository
+						list-repositories
+						check-config
+					
+				Configuration
+				Encryption
+			
+	
+	
+		dav-sync
+			
+				Introduction
+				Commands
+					
+						pull
+						push
+						resolve-conflicts
+						delete-conflicts
+						trash-info
+						empty-trash
+						add-directory
+						list-directories
+						check-config
+						check-repositories
+					
+				Configuration
+			
+	
+
+
+
+
+
+DavUtils documentation
+
+Home of the documentation for the dav cmd tools version 1.x.
+
+Authors
+Olaf Wintermann
+Mike Becker
+
+License
+Copyright 2017 Olaf Wintermann. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+  1. Redistributions of source code must retain the above copyright
+     notice, this list of conditions and the following disclaimer.
+
+  2. Redistributions in binary form must reproduce the above copyright
+     notice, this list of conditions and the following disclaimer in the
+     documentation and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.
+

+
+

+
+
+
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/info.html
--- a/docs/html/info.html	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/html/info.html	Sun Aug 06 18:18:00 2017 +0200
@@ -10,7 +10,7 @@
 
 
 
-	davutils documentation
+	DavUtils documentation
 
 
 	
@@ -67,7 +67,7 @@
 
 dav info
 
-info [-pc] <url>
+dav info [-pc] <url>
 Prints some information and lists all properties for the resource specified by url.
 Example 1: info of a collection
 In this example myserv is a configured repository with the base url https://example.com/webdav/. Because the collection is not encrypted, the url in the info output is just the path appended to the base url.
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/introduction.html
--- a/docs/html/introduction.html	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/html/introduction.html	Sun Aug 06 18:18:00 2017 +0200
@@ -10,7 +10,7 @@
 
 
 
-	davutils documentation
+	DavUtils documentation
 
 
 	
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/list-directories.html
--- a/docs/html/list-directories.html	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/html/list-directories.html	Sun Aug 06 18:18:00 2017 +0200
@@ -10,7 +10,7 @@
 
 
 
-	davutils documentation
+	DavUtils documentation
 
 
 	
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/list-repositories.html
--- a/docs/html/list-repositories.html	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/html/list-repositories.html	Sun Aug 06 18:18:00 2017 +0200
@@ -10,7 +10,7 @@
 
 
 
-	davutils documentation
+	DavUtils documentation
 
 
 	
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/list.html
--- a/docs/html/list.html	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/html/list.html	Sun Aug 06 18:18:00 2017 +0200
@@ -10,7 +10,7 @@
 
 
 
-	davutils documentation
+	DavUtils documentation
 
 
 	
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/lock.html
--- a/docs/html/lock.html	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/html/lock.html	Sun Aug 06 18:18:00 2017 +0200
@@ -10,7 +10,7 @@
 
 
 
-	davutils documentation
+	DavUtils documentation
 
 
 	
@@ -67,7 +67,7 @@
 
 dav lock
 
-lock [-pc] <url>
+dav lock [-pc] <url>
 Creates a lock on the resource specified by the url. The lock is an exclusive write lock with infinite depth.
 If the resource is successfully locked, a lock token for this resource is printed to stdout. This lock token should be saved somewhere to unlock the resource eventually.
 -p disable file name and path decryption if enabled
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/mkdir.html
--- a/docs/html/mkdir.html	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/html/mkdir.html	Sun Aug 06 18:18:00 2017 +0200
@@ -10,7 +10,7 @@
 
 
 
-	davutils documentation
+	DavUtils documentation
 
 
 	
@@ -67,7 +67,7 @@
 
 dav mkdir
 
-mkdir [-pc] [-k <key>] [-L <lock>] <url>
+dav mkdir [-pc] [-k <key>] [-L <lock>] <url>
 Creates a collection. All intermediate collections are also created as necessary.
 -p disable file name encryption and decryption
 -c enable file file name and content encryption
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/move.html
--- a/docs/html/move.html	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/html/move.html	Sun Aug 06 18:18:00 2017 +0200
@@ -10,7 +10,7 @@
 
 
 
-	davutils documentation
+	DavUtils documentation
 
 
 	
@@ -67,7 +67,7 @@
 
 dav move
 
-move [-pcO] [-L <lock>] <url> <url>
+dav move [-pcO] [-L <lock>] <url> <url>
 Moves the resource identified by url1 to the location url2. Currently url1 and url2 must be on the same host.
 If url2 already exists, the command aborts, unless the -O option is specified.
 The command uses a single WebDAV MOVE request to move the resources. You may use file name and path decryption to copy and encrypted resource. Please note that the target location will be exactly url2, so the top most collection name will not be disguised. See [encryption][2] for more details on how encryption works.
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/pull.html
--- a/docs/html/pull.html	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/html/pull.html	Sun Aug 06 18:18:00 2017 +0200
@@ -10,7 +10,7 @@
 
 
 
-	davutils documentation
+	DavUtils documentation
 
 
 	
@@ -67,7 +67,7 @@
 
 dav-sync pull
 
-pull [-cld] <directory>
+dav-sync pull [-cld] <directory>
 Pulls all changes from the server. All new or modified files are downloaded and all files deleted on the server are deleted locally. If a file is also locally modified and conflict detection is not disabled, the local file is renamed and an entry in the conflict database is added.
 When a trash directory is configured for the SyncDirectory, all files that would be deleted are instead moved to the trash directory.
 When backup-on-pull is enabled for the SyncDirectory, all files that would be overwritten are also moved to the trash.
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/push.html
--- a/docs/html/push.html	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/html/push.html	Sun Aug 06 18:18:00 2017 +0200
@@ -10,7 +10,7 @@
 
 
 
-	davutils documentation
+	DavUtils documentation
 
 
 	
@@ -67,7 +67,7 @@
 
 dav-sync push
 
-push [-cld] <directory>
+dav-sync push [-cld] <directory>
 Pushes all local changes to the server. This uploads all locally modified files and deletes all locally deleted files on the server.
 If conflict detection is not disabled, all files that are also modified on the server will be skipped.
 -c Disable conflict detection. This always overwrites files on the server
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/put.html
--- a/docs/html/put.html	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/html/put.html	Sun Aug 06 18:18:00 2017 +0200
@@ -10,7 +10,7 @@
 
 
 
-	davutils documentation
+	DavUtils documentation
 
 
 	
@@ -67,7 +67,7 @@
 
 dav put
 
-put [-pcR] [-k <key>] [-L <lock>] <url> <file>
+dav put [-pcR] [-k <key>] [-L <lock>] <url> <file>
 Uploads a file or a directory. When uploading a file while the url points to an existing collection, a resource inside this collection with the file's name is created. When the url points to a non-existing resource, the resource is created.
 When uploading a directory, you need to specify the -R option. It uploads all files in the directory to the specified url, but it does not create a collection for the directory itself. You may use dav mkdir to create this collection beforehand.
 -p disable file name encryption and decryption
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/remove.html
--- a/docs/html/remove.html	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/html/remove.html	Sun Aug 06 18:18:00 2017 +0200
@@ -10,7 +10,7 @@
 
 
 
-	davutils documentation
+	DavUtils documentation
 
 
 	
@@ -67,7 +67,7 @@
 
 dav remove
 
-remove [-pc] [-L <lock>] <url>
+dav remove [-pc] [-L <lock>] <url>
 Removes a resource. When removing a collection, all child resources are also removed.
 -p disable file name and path decryption if enabled
 -c enable file name and path decryption
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/resolve-conflicts.html
--- a/docs/html/resolve-conflicts.html	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/html/resolve-conflicts.html	Sun Aug 06 18:18:00 2017 +0200
@@ -10,7 +10,7 @@
 
 
 
-	davutils documentation
+	DavUtils documentation
 
 
 	
@@ -67,7 +67,7 @@
 
 dav-sync resolve-conflicts
 
-resolve-conflicts <directory>
+dav-sync resolve-conflicts <directory>
 Removes conflict entries from the database. This does not merge any files. All files which are marked as conflict are normal files after running this command. In other words: by executing this command you assert that you have resolved the conflicts.
 
 
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/set-property.html
--- a/docs/html/set-property.html	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/html/set-property.html	Sun Aug 06 18:18:00 2017 +0200
@@ -10,7 +10,7 @@
 
 
 
-	davutils documentation
+	DavUtils documentation
 
 
 	
@@ -67,7 +67,7 @@
 
 dav set-property
 
-set-property [-pc] [-L <lock>] [-n <uri>] <url> <property> [value]
+dav set-property [-pc] [-L <lock>] [-n <uri>] <url> <property> [value]
 Sets a resource property to the specified value.
 property is a property name with or without prefix (see get-property for details).
 If no value is specified, the content for the property is read from stdin.
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/sync-check-config.html
--- a/docs/html/sync-check-config.html	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/html/sync-check-config.html	Sun Aug 06 18:18:00 2017 +0200
@@ -10,7 +10,7 @@
 
 
 
-	davutils documentation
+	DavUtils documentation
 
 
 	
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/sync-commands.html
--- a/docs/html/sync-commands.html	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/html/sync-commands.html	Sun Aug 06 18:18:00 2017 +0200
@@ -10,7 +10,7 @@
 
 
 
-	davutils documentation
+	DavUtils documentation
 
 
 	
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/sync-configuration.html
--- a/docs/html/sync-configuration.html	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/html/sync-configuration.html	Sun Aug 06 18:18:00 2017 +0200
@@ -10,7 +10,7 @@
 
 
 
-	davutils documentation
+	DavUtils documentation
 
 
 	
@@ -71,71 +71,52 @@
 The sync.xml file is an XML file with <configuration> as root element. This element can only have <directory> elements as children.
 directory
 This element configures a sync-directory. A sync-directory must have a unique name, a (local) path, repository and a database.
-Required elements: <name>, <repository>, <path>, <database>

-Optional elements: <collection>, <trash>, <max-retry>, <backup-on-pull>, <lock-pull>, <lock-push>, <filter>
+Required elements: <name>, <repository>, <path>, <database>
Optional elements: <collection>, <trash>, <max-retry>, <backup-on-pull>, <lock-pull>, <lock-push>, <filter>
 name
 Unique sync-directory identifer. This identifer is used in combination with all dav-sync commands.
-Type: string

-Example: <name>mysyncdir</name>
+Type: string
Example: <name>mysyncdir</name>
 repository
 Name of the WebDAV-repository. A repository with the same name must be configured in [config.xml][1].
-Type: string

-Example: <name>myrepo</name>
+Type: string
Example: <name>myrepo</name>
 path
 The path of the local directory that should be synchronized. The path must be an absolute path or start with an environment variable. A path with an environment variable must start with an $ followed by the variable name optionally followed by a path. For example:
 `<path>$HOME/Documents</path>`
 The part between $ and / is the environment variable name.
-Type: string

-Example: <path>/absolute/path</path>
+Type: string
Example: <path>/absolute/path</path>
 database
 Path to the database file used for this sync-directory. The path must be relative to the $HOME/.dav/ directory.
-Type: string

-Example: <database>myrepo-db.xml</database>
+Type: string
Example: <database>myrepo-db.xml</database>
 collection
 Path of the collection relative to the repository root collection. For example if the repository url is http://example.com/webdav/ and the collection value is /myfiles/, the directory is synchronized with http://example.com/webdav/myfiles/
-Type: string

-Default: /

-Example: <collection>/myfiles</collection>
+Type: string
Default: /
Example: <collection>/myfiles</collection>
 trash
 Path to the trash directory for this sync-directory. Files that should be deleted will be moved to this directory. The value must be an absolute path or relative to the sync-directory path.
-Type: string

-Example: <trash>.trash</trash>
+Type: string
Example: <trash>.trash</trash>
 max-retry
 This integer value controls how many attempts of downloading/uploading a file in case of an error are made.
-Type: integer

-Default: 0

-Example: <max-retry>3</max-retry>
+Type: integer
Default: 0
Example: <max-retry>3</max-retry>
 backup-on-pull
 If this element has the value of true, the pull command will move old local files to the trash directory before downloading the new version from the server.
-Type: boolean

-Default: false

-Example: <backup-on-pull>true</backup-on-pull>
+Type: boolean
Default: false
Example: <backup-on-pull>true</backup-on-pull>
 lock-pull
 Enables locking for the pull command.
-Type: boolean

-Default: false

-Example: <lock-pull>true</lock-pull>
+Type: boolean
Default: false
Example: <lock-pull>true</lock-pull>
 lock-push
 Enables locking for the push command.
-Type: boolean

-Default: false

-Example: <lock-push>true</lock-push>
+Type: boolean
Default: false
Example: <lock-push>true</lock-push>
 filter
 With the filter element, include and exclude filters can be specified, to control which files are synchronized. The pull and push command apply these filters to file paths. At first it is checked if a file is matching any include filter. If so only files matching not an exclude filter are further processed.
 Note: The file path is relative to the directory path (and WebDAV collection) but always starts with an path separator.
 Optional elements: <include>, <exclude>
 include
 Controls which files will be included by pull and push. If an include filter is specified, only files matching this filter are included.
-Type: regex string

-Default: .*

-Example:
+Type: regex string
Default: .*
Example:
 <filter>
     <include>\.pdf$</include>
 </filter>
 exclude
 Controls which files will be excluded by pull and push.
-Type: regex string

-Example:
+Type: regex string
Example:
 <filter>
     <exclude>^/secretdir</exclude>
     <exclude>\.DS_Store$</exclude>
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/trash-info.html
--- a/docs/html/trash-info.html	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/html/trash-info.html	Sun Aug 06 18:18:00 2017 +0200
@@ -10,7 +10,7 @@
 
 
 
-	davutils documentation
+	DavUtils documentation
 
 
 	
@@ -67,7 +67,7 @@
 
 dav-sync trash-info
 
-trash-info <directory>
+dav-sync trash-info <directory>
 Shows the trash directory path for a sync-directory, the number of files currently in trash and the space they consume.
 
 
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/html/unlock.html
--- a/docs/html/unlock.html	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/html/unlock.html	Sun Aug 06 18:18:00 2017 +0200
@@ -10,7 +10,7 @@
 
 
 
-	davutils documentation
+	DavUtils documentation
 
 
 	
@@ -67,7 +67,7 @@
 
 dav unlock
 
-unlock [-pc] [-L <lock>] <url>
+dav unlock [-pc] [-L <lock>] <url>
 Unlocks the specified url with a lock token. If no lock token is specified with the -L option, it read from stdin.
 -p disable file name and path decryption if enabled
 -c enable file name and path decryption
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/src/Makefile
--- a/docs/src/Makefile	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/src/Makefile	Sun Aug 06 18:18:00 2017 +0200
@@ -66,7 +66,7 @@
 
 HTML = $(SRC:%.md=build/%.html)
 
-FILES = build/davdoc.css
+FILES = build/davdoc.css build/index.html
 
 all: doc
 
@@ -82,6 +82,9 @@
 build/davdoc.css:
 	cp davdoc.css build
 
+build/index.html:
+	cp index.html build
+
 dist: doc
 	rm -Rf ../html; cp -R build ../html
 
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/src/copy.md
--- a/docs/src/copy.md	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/src/copy.md	Sun Aug 06 18:18:00 2017 +0200
@@ -2,7 +2,7 @@
 title: 'dav copy'
 ---
 
-**`copy [-pcO] [-L ]  `**
+**`dav copy [-pcO] [-L ]  `**
 
 Creates a duplicate of the resource identified by *url1* at the location *url2*. All resource properties are copied. Currently *url1* and *url2* must be the same host. 
 
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/src/date.md
--- a/docs/src/date.md	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/src/date.md	Sun Aug 06 18:18:00 2017 +0200
@@ -2,7 +2,7 @@
 title: 'dav date'
 ---
 
-**`date [url]`**
+**`dav date [url]`**
 
 The purpose of this command is to get the current date from a server and print it to stdout (HTTP date format). This in useful in combination with the **`-u`** option for the `list` and `get` command.
 
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/src/davdoc.css
--- a/docs/src/davdoc.css	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/src/davdoc.css	Sun Aug 06 18:18:00 2017 +0200
@@ -21,6 +21,20 @@
     float: right;
 }
 
+.header a:link {
+	text-decoration: none;
+	color: black;
+}
+
+.header a:visited {
+	text-decoration: none;
+	color: black;
+}
+
+.header a:hover {
+	color: #e68a00;
+}
+
 .sidebar {
     float: left;
     width: 15em;
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/src/delete-conflicts.md
--- a/docs/src/delete-conflicts.md	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/src/delete-conflicts.md	Sun Aug 06 18:18:00 2017 +0200
@@ -2,7 +2,7 @@
 title: 'dav-sync delete-conflicts'
 ---
 
-**`delete-conflicts `**
+**`dav-sync delete-conflicts `**
 
 Deletes all files that are marked as a conflict. This will always delete the files and does not move them to the trash directory.
 
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/src/empty-trash.md
--- a/docs/src/empty-trash.md	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/src/empty-trash.md	Sun Aug 06 18:18:00 2017 +0200
@@ -2,7 +2,7 @@
 title: 'dav-sync empty-trash'
 ---
 
-**`empty-trash `**
+**`dav-sync empty-trash `**
 
 Removes all files from the trash directory of the given sync-directory.
 
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/src/get-property.md
--- a/docs/src/get-property.md	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/src/get-property.md	Sun Aug 06 18:18:00 2017 +0200
@@ -2,7 +2,7 @@
 title: 'dav get-property'
 ---
 
-**`get-property [-pc] [-n ]  `**
+**`dav get-property [-pc] [-n ]  `**
 
 Gets a specific resource property. Every WebDAV property has a name and an XML namespace. A namespace can be specified with the `-n` option or with a prefixed name. The prefix and property name are separated by a **:** as usual.
 
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/src/get.md
--- a/docs/src/get.md	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/src/get.md	Sun Aug 06 18:18:00 2017 +0200
@@ -2,7 +2,7 @@
 title: 'dav get'
 ---
 
-**`get [-pcR] [-o ] [-u ] `**
+**`dav get [-pcR] [-o ] [-u ] `**
 
 Downloads a resource. This command also downloads collections and its child resources when the **`-R`** option is used.
 When downloading a single resource, the default local file name is the resource
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/src/header.html
--- a/docs/src/header.html	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/src/header.html	Sun Aug 06 18:18:00 2017 +0200
@@ -1,5 +1,5 @@
 
-	davutils documentation
+	DavUtils documentation
 
 
 	
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/src/index.html
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/src/index.html	Sun Aug 06 18:18:00 2017 +0200
@@ -0,0 +1,105 @@
+
+
+
+  
+  
+  
+  DavUtils - cmd tools documentation
+  
+  
+
+
+
+	DavUtils documentation
+
+
+	
+		dav
+			
+				Getting started
+				Commands
+					
+						list
+						get
+						put
+						mkdir
+						remove
+						copy
+						move
+						get-property
+						set-property
+						lock
+						unlock
+						info
+						date
+						add-repository
+						list-repositories
+						check-config
+					
+				Configuration
+				Encryption
+			
+	
+	
+		dav-sync
+			
+				Introduction
+				Commands
+					
+						pull
+						push
+						resolve-conflicts
+						delete-conflicts
+						trash-info
+						empty-trash
+						add-directory
+						list-directories
+						check-config
+						check-repositories
+					
+				Configuration
+			
+	
+
+
+
+
+
+DavUtils documentation
+
+Home of the documentation for the dav cmd tools version 1.x.
+
+Authors
+Olaf Wintermann
+Mike Becker
+
+License
+Copyright 2017 Olaf Wintermann. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+  1. Redistributions of source code must retain the above copyright
+     notice, this list of conditions and the following disclaimer.
+
+  2. Redistributions in binary form must reproduce the above copyright
+     notice, this list of conditions and the following disclaimer in the
+     documentation and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.
+
+
+
+
+
+
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/src/info.md
--- a/docs/src/info.md	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/src/info.md	Sun Aug 06 18:18:00 2017 +0200
@@ -2,7 +2,7 @@
 title: 'dav info'
 ---
 
-**`info [-pc] `**
+**`dav info [-pc] `**
 
 Prints some information and lists all properties for the resource specified by *url*.
 
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/src/lock.md
--- a/docs/src/lock.md	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/src/lock.md	Sun Aug 06 18:18:00 2017 +0200
@@ -2,7 +2,7 @@
 title: 'dav lock'
 ---
 
-**`lock [-pc] `**
+**`dav lock [-pc] `**
 
 Creates a lock on the resource specified by the *url*. The lock is an exclusive write lock with infinite depth.
 
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/src/mkdir.md
--- a/docs/src/mkdir.md	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/src/mkdir.md	Sun Aug 06 18:18:00 2017 +0200
@@ -2,7 +2,7 @@
 title: 'dav mkdir'
 ---
 
-**`mkdir [-pc] [-k ] [-L ] `**
+**`dav mkdir [-pc] [-k ] [-L ] `**
 
 Creates a collection. All intermediate collections are also created as necessary.
 
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/src/move.md
--- a/docs/src/move.md	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/src/move.md	Sun Aug 06 18:18:00 2017 +0200
@@ -2,7 +2,7 @@
 title: 'dav move'
 ---
 
-**`move [-pcO] [-L ]  `**
+**`dav move [-pcO] [-L ]  `**
 
 Moves the resource identified by *url1* to the location *url2*. Currently *url1* and *url2* must be on the same host. 
 
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/src/pull.md
--- a/docs/src/pull.md	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/src/pull.md	Sun Aug 06 18:18:00 2017 +0200
@@ -2,7 +2,7 @@
 title: 'dav-sync pull'
 ---
 
-**`pull [-cld] `**
+**`dav-sync pull [-cld] `**
 
 Pulls all changes from the server. All new or modified files are downloaded and all files deleted on the server are deleted locally. If a file is also locally modified and conflict detection is not disabled, the local file is renamed and an entry in the conflict database is added.
 
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/src/push.md
--- a/docs/src/push.md	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/src/push.md	Sun Aug 06 18:18:00 2017 +0200
@@ -2,7 +2,7 @@
 title: 'dav-sync push'
 ---
 
-**`push [-cld] `**
+**`dav-sync push [-cld] `**
 
 Pushes all local changes to the server. This uploads all locally modified files and deletes all locally deleted files on the server.
 
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/src/put.md
--- a/docs/src/put.md	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/src/put.md	Sun Aug 06 18:18:00 2017 +0200
@@ -2,7 +2,7 @@
 title: 'dav put'
 ---
 
-**`put [-pcR] [-k ] [-L ]  `**
+**`dav put [-pcR] [-k ] [-L ]  `**
 
 Uploads a file or a directory. When uploading a file while the url points to
 an existing collection, a resource inside this collection with the file's name is created. When the url points to a non-existing resource, the resource is
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/src/remove.md
--- a/docs/src/remove.md	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/src/remove.md	Sun Aug 06 18:18:00 2017 +0200
@@ -2,7 +2,7 @@
 title: 'dav remove'
 ---
 
-**`remove [-pc] [-L ] `**
+**`dav remove [-pc] [-L ] `**
 
 Removes a resource. When removing a collection, all child resources are also
 removed.
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/src/resolve-conflicts.md
--- a/docs/src/resolve-conflicts.md	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/src/resolve-conflicts.md	Sun Aug 06 18:18:00 2017 +0200
@@ -2,7 +2,7 @@
 title: 'dav-sync resolve-conflicts'
 ---
 
-**`resolve-conflicts `**
+**`dav-sync resolve-conflicts `**
 
 Removes conflict entries from the database. This does not merge any files. All files which are marked as conflict are normal files after running this command.
 In other words: by executing this command you assert that *you* have resolved the conflicts.
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/src/set-property.md
--- a/docs/src/set-property.md	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/src/set-property.md	Sun Aug 06 18:18:00 2017 +0200
@@ -2,7 +2,7 @@
 title: 'dav set-property'
 ---
 
-**`set-property [-pc] [-L ] [-n ]   [value]`**
+**`dav set-property [-pc] [-L ] [-n ]   [value]`**
 
 Sets a resource property to the specified value.
 
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/src/trash-info.md
--- a/docs/src/trash-info.md	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/src/trash-info.md	Sun Aug 06 18:18:00 2017 +0200
@@ -2,7 +2,7 @@
 title: 'dav-sync trash-info'
 ---
 
-**`trash-info `**
+**`dav-sync trash-info `**
 
 Shows the trash directory path for a sync-directory, the number of files currently in trash and the space they consume.
 
diff -r 8e7ef0675946 -r 02d3e4b1245f docs/src/unlock.md
--- a/docs/src/unlock.md	Sun Aug 06 17:02:25 2017 +0200
+++ b/docs/src/unlock.md	Sun Aug 06 18:18:00 2017 +0200
@@ -2,7 +2,7 @@
 title: 'dav unlock'
 ---
 
-**`unlock [-pc] [-L ] `**
+**`dav unlock [-pc] [-L ] `**
 
 Unlocks the specified *url* with a lock token. If no lock token is specified with the `-L` option, it read from stdin.