[Xen-devel] [PATCH 16/18] xl.pod.1: improve description of virtual device subcommands

[<stefano.stabellini@xxxxxxxxxxxxx>]

From: Stefano Stabellini <stefano.stabellini@xxxxxxxxxxxxx>

Add a reference to docs/misc/xl-disk-configuration.txt and
docs/misc/xl-network-configuration.markdown.

Signed-off-by: Stefano Stabellini <stefano.stabellini@xxxxxxxxxxxxx>
---
 docs/man/xl.pod.1 |   18 +++++++++++++-----
 1 files changed, 13 insertions(+), 5 deletions(-)

diff --git a/docs/man/xl.pod.1 b/docs/man/xl.pod.1
index 720e3b9..15a9870 100644
--- a/docs/man/xl.pod.1
+++ b/docs/man/xl.pod.1
@@ -717,8 +717,8 @@ Splits up the machine into one cpu-pool per numa node.
 =head1 VIRTUAL DEVICE COMMANDS
 
 Most virtual devices can be added and removed while guests are
-running.  The effect to the guest OS is much the same as any hotplug
-event.
+running, assuming that the necessary support exists in the guest.  The
+effect to the guest OS is much the same as any hotplug event.
 
 =head2 BLOCK DEVICES
 
@@ -740,7 +740,8 @@ The domain id of the guest domain that the device will be 
attached to.
 =item I<disc-spec-component>
 
 A disc specification in the same format used for the B<disk> variable in
-the domain config file. See L<xldomain.cfg>.
+the domain config file. See L<xldomain.cfg> and
+I<docs/misc/xl-disk-configuration.txt>.
 
 =back
 
@@ -795,8 +796,8 @@ I<VirtualDevice> is the cdrom device in the guest to eject.
 
 Creates a new network device in the domain specified by I<domain-id>.
 I<network-device> describes the device to attach, using the same format as the
-B<vif> string in the domain config file. See L<xldomain.cfg> for the
-description.
+B<vif> string in the domain config file. See L<xldomain.cfg> and
+I<docs/misc/xl-network-configuration.markdown> for more informations.
 
 =item B<network-detach> I<domain-id> I<devid|mac>
 
@@ -918,8 +919,15 @@ Xen Flask security module.
 
 =head1 SEE ALSO
 
+The following man pages:
+
 B<xldomain.cfg>(5), B<xlcpupool.cfg>(5), B<xentop>(1)
 
+And the following documents available in the Xen source tree:
+
+B<docs/misc/xl-network-configuration.markdown>
+B<docs/misc/xl-disk-configuration.txt>
+
 =head1 AUTHOR
 
   Stefano Stabellini <stefano.stabellini@xxxxxxxxxxxxx>
-- 
1.7.2.3


_______________________________________________
Xen-devel mailing list
Xen-devel@xxxxxxxxxxxxxxxxxxx
http://lists.xensource.com/xen-devel