diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
index 43102c8d11..9bcef6a290 100644
--- a/docs/formatdomain.html.in
+++ b/docs/formatdomain.html.in
@@ -3103,15 +3103,18 @@
possible values pci-root, pcie-root,
pcie-root-port, pci-bridge,
dmi-to-pci-bridge, pcie-switch-upstream-port,
- pcie-switch-downstream-port, or pci-expander-bus.
- (pci-root and pci-bridge since 1.0.5,
- pcie-root and dmi-to-pci-bridge since
- 1.1.2, pcie-root-port, pcie-switch-upstream-port,
- pcie-switch-downstream-port since 1.2.19,
- and pci-expander-bus since 1.3.4)
- The root controllers (pci-root and pcie-root)
- have an optional pcihole64 element specifying how big
- (in kilobytes, or in the unit specified by pcihole64's
+ pcie-switch-downstream-port, pci-expander-bus,
+ or pcie-expander-bus. (pci-root and
+ pci-bridge since 1.0.5, pcie-root and
+ dmi-to-pci-bridge since 1.1.2,
+ pcie-root-port, pcie-switch-upstream-port,
+ pcie-switch-downstream-port since
+ 1.2.19, and pci-expander-bus and
+ pcie-expander-bus since 1.3.4) The
+ root controllers (pci-root
+ and pcie-root) have an
+ optional pcihole64 element specifying how big (in
+ kilobytes, or in the unit specified by pcihole64's
unit attribute) the 64-bit PCI hole should be. Some guests (like
Windows XP or Windows Server 2003) might crash when QEMU and Seabios
are recent enough to support 64-bit PCI holes, unless this is disabled
@@ -3173,7 +3176,7 @@
busNr
- pci-expander-bus controllers can have an
+ pci-expander-bus and pcie-expander-bus controllers can have an
optional busNr attribute (1-254). This will be
the bus number of the new bus; All bus numbers between that
specified and 255 will be available only for assignment to
@@ -3188,6 +3191,23 @@
for the pci-bridge that is automatically attached to it (if
you plan on adding more pci-bridges to the hierarchy of the
bus, you should manually set busNr to a lower value).
+
+ A similar algorithm is used for automatically determining
+ the busNr attribute for pcie-expander-bus, but since the
+ pcie-expander-bus doesn't have any built-in pci-bridge, the
+ 2nd bus-number is just being reserved for the pcie-root-port
+ that must necessarily be connected to the bus in order to
+ actually plug in an endpoint device. If you intend to plug
+ multiple devices into a pcie-expander-bus, you must instead
+ connect a pcie-switch-upstream-port to the
+ pcie-expander-bus, and multiple pcie-switch-downstream-ports
+ to the pcie-switch-downstream-port, and of course for this
+ to work properly, you will need to decrease the
+ pcie-expander-bus' busNr accordingly so that there are
+ enough unused bus numbers above it to accomodate giving out
+ one bus number for the upstream-port and one for each
+ downstream-port).
+