man: virt-install: Update --controller docs

Drop type value lists, add example invocations, document
q35_pcie_root_ports

Signed-off-by: Cole Robinson <crobinso@redhat.com>

1 files changed, 16 insertions, 11 deletions

diff --git a/man/virt-install.rst b/man/virt-install.rst
index 85a22f98..e43ffff6 100644
--- a/man/virt-install.rst
+++ b/man/virt-install.rst
@@ -1489,20 +1489,25 @@ See ``https://libvirt.org/formatdomain.html#elementsAddress`` for details.
 
 **Syntax:** ``--controller`` OPTIONS
 
-Attach a controller device to the guest. TYPE is one of:
-``ide``, ``fdc``, ``scsi``, ``sata``, ``virtio-serial``, or ``usb`` .
+Attach a controller device to the guest.
 
-Controller also supports the special values ``usb2`` and ``usb3`` to
-specify which version of the USB controller should be used (version 2
-or 3).
+Some example invocations:
 
-Some example suboptions:
+``--controller usb2``
+    Add a full USB2 controller setup
+
+``--controller usb3``
+    Add a USB3 controller
+
+``--controller type=usb,model=none``
+    Disable USB entirely
+
+``--controller type=scsi,model=virtio-scsi``
+    Add a VirtIO SCSI controller
 
-``model``
-    Controller model.  These may vary according to the hypervisor and its
-    version.  Most commonly used models are e.g. ``auto`` , ``virtio-scsi``
-    for the ``scsi`` controller, ``ehci`` or ``none``for the ``usb``
-    controller.
+``--controller q35_pcie_root_ports=NUM``
+    Control the number of default ``pcie-root-port`` controller devices
+    we add to the new VM by default, if the VM will use the q35 machine type.
 
 Use --controller=? to see a list of all available sub options.
 Complete details at https://libvirt.org/formatdomain.html#elementsControllers