From 425a6837a6e87a15d1f3f802fe7b17e4e0dc5cae Mon Sep 17 00:00:00 2001
From: Pavel Hrdina <phrdina@redhat.com>
Date: Wed, 25 Jan 2017 10:49:16 +0100
Subject: [PATCH] doc: improve VNC/SPICE password documentation

If the passwd attribute is set to empty string it disables VNC/SPICE
access to the guest.

Signed-off-by: Pavel Hrdina <phrdina@redhat.com>
---
 docs/formatdomain.html.in | 25 ++++++++++++++-----------
 1 file changed, 14 insertions(+), 11 deletions(-)

diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
index 1bbece0e52..77d8e71899 100644
--- a/docs/formatdomain.html.in
+++ b/docs/formatdomain.html.in
@@ -5518,12 +5518,13 @@ qemu-kvm -net nic,model=? /dev/null
               should be auto-allocated). The <code>autoport</code> attribute is
               the new preferred syntax for indicating auto-allocation of the TCP
               port to use. The <code>passwd</code> attribute provides a VNC
-              password in clear text. The <code>keymap</code> attribute specifies
-              the keymap to use. It is possible to set a limit on the validity of
-              the password by giving an timestamp
-              <code>passwdValidTo='2010-04-09T15:51:00'</code> assumed to be
-              in UTC. The <code>connected</code> attribute allows control of
-              connected client during password changes. VNC accepts
+              password in clear text. If the <code>passwd</code> attribute is
+              set to an empty string, then VNC access is disabled. The
+              <code>keymap</code> attribute specifies the keymap to use. It is
+              possible to set a limit on the validity of the password by giving
+              an timestamp <code>passwdValidTo='2010-04-09T15:51:00'</code>
+              assumed to be in UTC. The <code>connected</code> attribute allows
+              control of connected client during password changes. VNC accepts
               <code>keep</code> value only <span class="since">since 0.9.3</span>.
               NB, this may not be supported by all hypervisors.
             </p>
@@ -5559,11 +5560,13 @@ qemu-kvm -net nic,model=? /dev/null
               an alternative secure port number. The <code>autoport</code>
               attribute is the new preferred syntax for indicating
               auto-allocation of needed port numbers. The <code>passwd</code>
-              attribute provides a SPICE password in clear text. The
-              <code>keymap</code> attribute specifies the keymap to use. It is
-              possible to set a limit on the validity of the password by giving
-              an timestamp <code>passwdValidTo='2010-04-09T15:51:00'</code>
-              assumed to be in UTC.
+              attribute provides a SPICE password in clear text. If the
+              <code>passwd</code> attribute is set to an empty string, then
+              SPICE access is disabled. The <code>keymap</code> attribute
+              specifies the keymap to use. It is possible to set a limit on
+              the validity of the password by giving an timestamp
+              <code>passwdValidTo='2010-04-09T15:51:00'</code> assumed to be
+              in UTC.
             </p>
             <p>
               The <code>connected</code> attribute allows control of connected
-- 
2.47.3