From 8cbd91a449e858631a5583aba6f96ec5037a07f7 Mon Sep 17 00:00:00 2001
From: Dmitry Mishin <dim@virtuozzo.com>
Date: Thu, 24 Dec 2015 19:40:26 +0300
Subject: [PATCH] docs: Describe new 'append' attribute for chardevs source

Signed-off-by: Dmitry Mishin <dim@virtuozzo.com>
---
 docs/formatdomain.html.in | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
index a8bd48e971..ce46f061d8 100644
--- a/docs/formatdomain.html.in
+++ b/docs/formatdomain.html.in
@@ -5227,7 +5227,7 @@ qemu-kvm -net nic,model=? /dev/null
       &lt;target port='0'/&gt;
     &lt;/serial&gt;
     &lt;serial type='file'&gt;
-      &lt;source path='/tmp/file'&gt;
+      &lt;source path='/tmp/file' append='on'&gt;
         &lt;seclabel model='dac' relabel='no'/&gt;
       &lt;/source&gt;
       &lt;target port='0'/&gt;
@@ -5263,6 +5263,14 @@ qemu-kvm -net nic,model=? /dev/null
         the per-domain setting</a>.
     </p>
 
+    <p>
+      If the interface <code>type</code> presented to the host is "file",
+      then the <code>source</code> element may contain an optional attribute
+      <code>append</code> that specifies whether or not the information in
+      the file should be preserved on domain restart. Allowed values are
+      "on" and "off" (default). <span class="since">Since 1.3.1</span>.
+    </p>
+
     <p>
       Each character device element has an optional
       sub-element <code>&lt;address&gt;</code> which can tie the