Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

docs: driver-api: virtio: parenthesize external reference targets

Parenthesize targets to links in "References" section to distinguish
them from remaining texts.

While at it, describe the second target.

Signed-off-by: Bagas Sanjaya <bagasdotme@gmail.com>
Message-Id: <20221220095828.27588-2-bagasdotme@gmail.com>
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>

authored by

Bagas Sanjaya and committed by
Michael S. Tsirkin
fb25d456 f9d9f57e

+5 -4
+5 -4
Documentation/driver-api/virtio/virtio.rst
··· 11 11 12 12 Virtio is an open standard that defines a protocol for communication 13 13 between drivers and devices of different types, see Chapter 5 ("Device 14 - Types") of the virtio spec `[1]`_. Originally developed as a standard 14 + Types") of the virtio spec (`[1]`_). Originally developed as a standard 15 15 for paravirtualized devices implemented by a hypervisor, it can be used 16 16 to interface any compliant device (real or emulated) with a driver. 17 17 ··· 43 43 All the buffers the descriptors point to are allocated by the guest and 44 44 used by the host either for reading or for writing but not for both. 45 45 46 - Refer to Chapter 2.5 ("Virtqueues") of the virtio spec `[1]`_ for the 47 - reference definitions of virtqueues and to `[2]`_ for an illustrated 48 - overview of how the host device and the guest driver communicate. 46 + Refer to Chapter 2.5 ("Virtqueues") of the virtio spec (`[1]`_) for the 47 + reference definitions of virtqueues and "Virtqueues and virtio ring: How 48 + the data travels" blog post (`[2]`_) for an illustrated overview of how 49 + the host device and the guest driver communicate. 49 50 50 51 The :c:type:`vring_virtqueue` struct models a virtqueue, including the 51 52 ring buffers and management data. Embedded in this struct is the