[libvirt] [PATCH] doc: improve VNC/SPICE password documentation

[John Ferlan]

On 01/25/2017 05:00 AM, Pavel Hrdina wrote:
> If the passwd attribute is set to empty string it disables VNC/SPICE
> access to the guest.
> 
> Signed-off-by: Pavel Hrdina <phrdina at redhat.com>
> ---
>  docs/formatdomain.html.in | 19 +++++++++++--------
>  1 file changed, 11 insertions(+), 8 deletions(-)
> 
> diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
> index 3f7f87524a..1cb94d0253 100644
> --- a/docs/formatdomain.html.in
> +++ b/docs/formatdomain.html.in
> @@ -5499,9 +5499,10 @@ 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
> +              password in clear text, if the <code>passwd</code> is set to empty
> +              string the 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

...in clear text. If the <code>passwd</code> is set to an empty string,
then VNC access...

>                <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
> @@ -5540,11 +5541,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> is set to empty string the 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.

(likewise)

...in clear text. If the <code>passwd</code> attribute is set to an
empty string, then SPICE access...

ACK w/ adjustments.

John
>              </p>

>              <p>
>                The <code>connected</code> attribute allows control of connected
>