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

[Peter Krempa]

On 11/20/14 16:08, John Ferlan wrote:
> 
> 
> 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.

I'm going to add <p>aragraphs around the text blocks. That will
automagically add a break before the table and will avoid having empty
paragraph block.

> 
> 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


-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 819 bytes
Desc: OpenPGP digital signature
URL: <http://listman.redhat.com/archives/libvir-list/attachments/20141120/c7e8fca3/attachment-0001.sig>