Improve a small piece of documentation

[Zig-03]

This is not a major issue, but two lines of text would add a lot of clarity to this piece of documentation. In this exact paragraph I don't understand what exactly I should type, everything that comes after 0000:? including /usb3 text or not? To avoid all this, adding two examples would make everything clearer. Thank you.

https://www.qubes-os.org/doc/assigning-devices/

Approximately expected documentation:

This should output something like:

../../../devices/pci-0/pci0000:00/0000:00:1a.0/usb3

Now you see the BDF address in the path (right before final usb3). Strip the leading 0000: and pass the rest to the qvm-pci tool to attach the controller with the version specific steps above.

On R 4.0 the command would look something like
qvm-pci attach --persistent personal dom0:00:1a.0/usb3

On R 3.2 the command would look something like
qvm-pci -a personal 00:1a.0/usb3

Actual documentation:

This should output something like:

../../../devices/pci-0/pci0000:00/0000:00:1a.0/usb3

Now you see the BDF address in the path (right before final usb3). Strip the leading 0000: and pass the rest to the qvm-pci tool to attach the controller with the version specific steps above.

p.s. I'm not sure if what comes after dom0 in this example qvm-pci attach --persistent personal dom0:00:1a.0/usb3 is correct, since I haven't figured out what exactly I should copy from here ../../../devices/pci-0/pci0000:00/0000:00:1a.0/usb3 to make the command work properly.

[t4777sd]

You can click "Edit this page" on the doc page to change the documentation. After editing it you have to send a pull request as it forks the docs.

[t4777sd]

You can click "Edit this page" on the doc page to change the documentation. After editing it you have to send a pull request as it forks the docs.

[Zig-03]

@t4777sd thanks, never done that. I'll try.

[Zig-03]

@t4777sd thanks, never done that. I'll try.

[andrewdavidwong]

More information about contributing to the documentation:

https://www.qubes-os.org/doc/doc-guidelines/

[andrewdavidwong]

More information about contributing to the documentation:

https://www.qubes-os.org/doc/doc-guidelines/