OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

virtio-comment message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: [PATCH 2/6] VIRTIO-74: required vs REQUIRED.


Some really are clearest as they are, but most are changed to avoid
confusion.

Signed-off-by: Rusty Russell <rusty@au1.ibm.com>
---
 content.tex      | 18 +++++++++---------
 introduction.tex |  2 +-
 2 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/content.tex b/content.tex
index cb40ae0..15557b4 100644
--- a/content.tex
+++ b/content.tex
@@ -172,7 +172,7 @@ See section \ref{sec:General Initialization And Device Operation / Device Initia
 Drivers MUST
 NOT limit structure size and device configuration space size.  Instead,
 drivers SHOULD only check that device configuration space is {\em large enough} to
-contain the fields required for device operation.
+contain the fields necessary for device operation.
 
 \begin{note}
 For example, if the specification states that device configuration
@@ -244,7 +244,7 @@ Used Ring         & 4         & $6 + 4 * $(Queue Size) \\
 The Alignment column gives the minimum alignment for each part
 of the virtqueue.
 
-The Size column gives the total number of bytes required for each
+The Size column gives the total number of bytes for each
 part of the virtqueue.
 
 Queue Size corresponds to the maximum number of buffers in the
@@ -280,7 +280,7 @@ Descriptor Table & Available Ring (\ldots padding\ldots) & Used Ring \\
 \end{tabular}
 
 The bus-specific Queue Size field controls the total number of bytes
-required for the virtqueue.
+for the virtqueue.
 When using the legacy interface, the transitional
 driver MUST retrieve the Queue Size field from the device
 and MUST allocate the total number of bytes for the virtuqueue
@@ -485,13 +485,13 @@ If the VIRTIO_RING_F_EVENT_IDX feature bit is not negotiated:
 \begin{itemize}
 \item The driver MUST set \field{flags} to 0 or 1.
 \item The driver MAY set \field{flags} to 1 to advise
-the device that interrupts are not required.
+the device that interrupts are not needed.
 \end{itemize}
 
 Otherwise, if the VIRTIO_RING_F_EVENT_IDX feature bit is negotiated:
 \begin{itemize}
 \item The driver MUST set \field{flags} to 0.
-\item The driver MAY use \field{used_event} to advise the device that interrupts are not required until the device writes entry with an index specified by \field{used_event} into the used ring (equivalently, until \field{idx} in the
+\item The driver MAY use \field{used_event} to advise the device that interrupts are unnecessary until the device writes entry with an index specified by \field{used_event} into the used ring (equivalently, until \field{idx} in the
 used ring will reach the value \field{used_event} + 1).
 \end{itemize}
 
@@ -597,13 +597,13 @@ If the VIRTIO_RING_F_EVENT_IDX feature bit is not negotiated:
 \begin{itemize}
 \item The device MUST set \field{flags} to 0 or 1.
 \item The device MAY set \field{flags} to 1 to advise
-the driver that notifications are not required.
+the driver that notifications are not needed.
 \end{itemize}
 
 Otherwise, if the VIRTIO_RING_F_EVENT_IDX feature bit is negotiated:
 \begin{itemize}
 \item The device MUST set \field{flags} to 0.
-\item The device MAY use \field{avail_event} to advise the driver that notifications are not required until the driver writes entry with an index specified by \field{avail_event} into the available ring (equivalently, until \field{idx} in the
+\item The device MAY use \field{avail_event} to advise the driver that notifications are unnecessary until the driver writes entry with an index specified by \field{avail_event} into the available ring (equivalently, until \field{idx} in the
 available ring will reach the value \field{avail_event} + 1).
 \end{itemize}
 
@@ -833,7 +833,7 @@ value before checking if notifications are suppressed.
 
 \drivernormative{\paragraph}{Notifying The Device}{General Initialization And Device Operation / Device Operation / Supplying Buffers to The Device / Notifying The Device}
 The driver MUST perform a suitable memory barrier before reading \field{flags} or
-\field{avail_event}, to avoid missing a required notification.
+\field{avail_event}, to avoid missing a notification.
 
 \subsection{Receiving Used Buffers From The Device}\label{sec:General Initialization And Device Operation / Device Operation / Receiving Used Buffers From The Device}
 
@@ -2897,7 +2897,7 @@ Some networking feature bits require other networking feature bits
 
 This was supposed to indicate segmentation offload support, but
 upon further investigation it became clear that multiple bits
-were required.
+were needed.
 
 \subsection{Device configuration layout}\label{sec:Device Types / Network Device / Device configuration layout}
 
diff --git a/introduction.tex b/introduction.tex
index 2194b36..f8ea424 100644
--- a/introduction.tex
+++ b/introduction.tex
@@ -119,7 +119,7 @@ Similarly, a driver MAY implement:
 \end{description}
 
 \begin{note}
-  No legacy interfaces are required; ie. don't implement them unless you
+  Legacy interfaces are not required; ie. don't implement them unless you
   have a need for backwards compatibility!
 \end{note}
 
-- 
1.8.3.2



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]