=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
=item I<disc-spec-component>
A disc specification in the same format used for the B<disk> variable in
-the domain config file. See F<xl-disk-configuration>.
+the domain config file. See
+L<http://xenbits.xen.org/docs/unstable/misc/xl-disk-configuration.txt>.
=back
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<xl.cfg(5)> for the
-description.
+B<vif> string in the domain config file. See L<xl.cfg> and
+L<http://xenbits.xen.org/docs/unstable/misc/xl-network-configuration.html>
+for more informations.
=item B<network-detach> I<domain-id> I<devid|mac>
=head1 SEE ALSO
-L<xl.cfg(5)>, L<xlcpupool.cfg(5)>, B<xentop(1)>
+The following man pages:
+
+L<xl.cfg>(5), L<xlcpupool.cfg>(5), B<xentop>(1)
+
+And the following documents on the xen.org website:
+
+L<http://xenbits.xen.org/docs/unstable/misc/xl-network-configuration.html>
+L<http://xenbits.xen.org/docs/unstable/misc/xl-disk-configuration.txt>
=head1 AUTHOR