[libvirt] [PATCH 01/12] docs: domain: Move docs for storage hosts under the <source> element

[John Ferlan]

On 11/12/2014 08:47 AM, Peter Krempa wrote:
> The docs describing the <host> element that are under the <source>
> element in the XML document were incorrectly placed under the <disk>
> element. Move them to the correct place.
> ---
>  docs/formatdomain.html.in | 104 ++++++++++++++++++++++++----------------------
>  1 file changed, 54 insertions(+), 50 deletions(-)
> 

> diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
> index d4189e6..4f44bc0 100644
> --- a/docs/formatdomain.html.in
> +++ b/docs/formatdomain.html.in
> @@ -1953,6 +1953,60 @@
>          may have zero or more <code>host</code> sub-elements used to
>          specify the hosts to connect.
>          </p>
> +
> +        <dl>
> +          <dt><code>host</code></dt>
> +          <dd>The <code>host</code> element supports 4 attributes, viz.  "name",
> +            "port", "transport" and "socket", which specify the hostname,
> +            the port number, transport type and path to socket, respectively.
> +            The meaning of this element and the number of the elements depend
> +            on the protocol attribute.

<p></p>

> +            <table class="top_table">
> +              <tr>
> +                <th> Protocol </th>
> +                <th> Meaning </th>
> +                <th> Number of hosts </th>
> +                <th> Default port </th>
> +              </tr>
> +              <tr>
> +                <td> nbd </td>
> +                <td> a server running nbd-server </td>
> +                <td> only one </td>
> +                <td> 10809 </td>
> +              </tr>
> +              <tr>
> +                <td> iscsi </td>
> +                <td> an iSCSI server </td>
> +                <td> only one </td>
> +                <td> 3260 </td>
> +              </tr>
> +              <tr>
> +                <td> rbd </td>
> +                <td> monitor servers of RBD </td>
> +                <td> one or more </td>
> +                <td> 6789 </td>
> +              </tr>
> +              <tr>
> +                <td> sheepdog </td>
> +                <td> one of the sheepdog servers (default is localhost:7000) </td>
> +                <td> zero or one </td>
> +                <td> 7000 </td>
> +              </tr>
> +              <tr>
> +                <td> gluster </td>
> +                <td> a server running glusterd daemon </td>
> +                <td> only one </td>
> +                <td> 24007 </td>
> +              </tr>
> +            </table>

<p></p>

ACK - adding the <p></p> is mostly a visual thing - it separates the
table from the text a bit... not sure if there's another way to do it as
my html skills are spartan.

John

> +            gluster supports "tcp", "rdma", "unix" as valid values for the
> +            transport attribute.  nbd supports "tcp" and "unix".  Others only
> +            support "tcp".  If nothing is specified, "tcp" is assumed. If the
> +            transport is "unix", the socket attribute specifies the path to an
> +            AF_UNIX socket.
> +          </dd>
> +        </dl>
> +
>          <p>
>          For a "file" or "volume" disk type which represents a cdrom or floppy
>          (the <code>device</code> attribute), it is possible to define
> @@ -2308,56 +2362,6 @@
>          characters.
>          <span class='since'>Since 1.0.1</span>
>        </dd>
> -      <dt><code>host</code></dt>
> -      <dd>The <code>host</code> element supports 4 attributes, viz.  "name",
> -        "port", "transport" and "socket", which specify the hostname, the port
> -         number, transport type and path to socket, respectively. The meaning
> -         of this element and the number of the elements depend on the protocol
> -         attribute.
> -        <table class="top_table">
> -          <tr>
> -            <th> Protocol </th>
> -            <th> Meaning </th>
> -            <th> Number of hosts </th>
> -            <th> Default port </th>
> -          </tr>
> -          <tr>
> -            <td> nbd </td>
> -            <td> a server running nbd-server </td>
> -            <td> only one </td>
> -            <td> 10809 </td>
> -          </tr>
> -          <tr>
> -            <td> iscsi </td>
> -            <td> an iSCSI server </td>
> -            <td> only one </td>
> -            <td> 3260 </td>
> -          </tr>
> -          <tr>
> -            <td> rbd </td>
> -            <td> monitor servers of RBD </td>
> -            <td> one or more </td>
> -            <td> 6789 </td>
> -          </tr>
> -          <tr>
> -            <td> sheepdog </td>
> -            <td> one of the sheepdog servers (default is localhost:7000) </td>
> -            <td> zero or one </td>
> -            <td> 7000 </td>
> -          </tr>
> -          <tr>
> -            <td> gluster </td>
> -            <td> a server running glusterd daemon </td>
> -            <td> only one </td>
> -            <td> 24007 </td>
> -          </tr>
> -        </table>
> -        gluster supports "tcp", "rdma", "unix" as valid values for the
> -        transport attribute.  nbd supports "tcp" and "unix".  Others only
> -        support "tcp".  If nothing is specified, "tcp" is assumed. If the
> -        transport is "unix", the socket attribute specifies the path to an
> -        AF_UNIX socket.
> -      </dd>
>        <dt><code>address</code></dt>
>        <dd>If present, the <code>address</code> element ties the disk
>          to a given slot of a controller (the
>