[libvirt] [PATCH] docs: describe new virtual switch configuration in network XML docs

Laine Stump laine at laine.org
Wed Aug 10 16:20:15 UTC 2011


On 08/10/2011 11:05 AM, Eric Blake wrote:
> On 08/09/2011 11:45 PM, Laine Stump wrote:
>> This should have been done with the rest of the patch for virtual
>> switch / network device abstraction.
>
> And I should have called you on this before the 0.9.4 release - oh 
> well :)


A long time ago I used to like writing documentation. I think the 
language center of my brain has atrophied in the last 20 years, though...


>
>> +      A portgroup provides a method of easily putting guest
>> +      connections to the network into different classes, with each
>> +      class potentially having a different level/type of service. Each
>> +      network can have multiple portgroup elements (and one of those
>> +      can optionally be designated as the 'default' portgroup for the
>> +      network), and each portgroup has a name, as well as various
>> +      subelements associated with it. The currently supported
>> +      subelements are<code><bandwidth></code>
>> +      and<code><virtualport></code>, which are both fully
>> +      described in the domain XML documentation.
>
> Is there any way to make cross-page relative links, so that you can 
> make this a link to the right section in the domain XML page? 


I did this up earlier in my patch, and it seems to work:

(see<a href="formatdomain.html#elementsNICSDirect">Direct attachment to physical interface</a>  for descriptions of the various macvtap modes)

But I didn't think to put a link here too. I did that, tested it, fixed 
a couple of formatting problems I didn't notice last night (missing ";" 
and pushed the result.


> But not a show-stopper to this patch if you aren't sure how.
>
> ACK.
>


Thanks.




More information about the libvir-list mailing list