vzdump: add section for notes and notes-template

Signed-off-by: Fabian Ebner <f.ebner@proxmox.com>

diff --git a/vzdump.adoc b/vzdump.adoc
index 093f639e1e961ed85e46f6f12819a714aff068ca..5a13d3ac58a5d9bd04643305119772315a68c455 100644 (file)
--- a/vzdump.adoc
+++ b/vzdump.adoc
@@ -306,6 +306,19 @@ backups per guest are allowed on the storage. Use `-1` for unlimited. The
 default is unlimited for users with `Datastore.Allocate` privilege and `5` for
 other users.
 
+[[vzdump_notes]]
+Backup Notes
+------------
+
+You can add notes to backups using the 'Edit Notes' button in the UI or via the
+storage content API. It is also possible to specify a template for generating
+notes dynamically for a backup job and for manual backup. The template string
+can contain variables, surrounded by two curly braces, which will be replaced by
+the corresponding value when the backup is executed. Currently supported are
+`{{cluster}}`, `{{guestname}}`, `{{node}}`, and `{{vmid}}`. When specified via
+API or CLI, it needs to be a single line, where newline and backslash need to be
+escaped as `\n` and `\\` respectively.
+
 [[vzdump_restore]]
 Restore
 -------