docs/src/edit.md

Sat, 28 Mar 2020 17:07:10 +0100

author
Mike Becker <universe@uap-core.de>
date
Sat, 28 Mar 2020 17:07:10 +0100
branch
feature/dav-edit
changeset 714
10a5d6ce0906
child 720
2b8a65ed6f4c
permissions
-rw-r--r--

adds documentation for the edit command

---
title: 'dav edit'
---

**`dav edit [-pc] [-k <key>] [-V <version>] <url>`**

Downloads a resources and opens an editor. If there is no resource at the
specified location, it is attempted to create a fresh resource.
The resource is downloaded to a temporary file and re-uploaded only if you save
any changes to that file.

The default editor `vi` can be changed with the `EDITOR` environment variable.

This command transparently handles decryption and encryption. If you download
and open a plain text file and request content encryption (either by config or
by command line option) the file will be re-uploaded with content encryption.
However, a present file will keep its (plain text) file name in any case.

**`-p`** disable file name encryption and decryption

**`-c`** enable file name and content encryption

**`-k <key>`** use the specified key for encryption. The key must be configured in
  the config.xml file

**`-V <version>`** downloads a specific version of the resource. Available versions can be listed with the *list-versions* command

mercurial