[virtio-comment] Re: [PATCH] device-types/multiple: replace queues with enqueues

["Michael S. Tsirkin" <mst@redhat.com>]

On Wed, Apr 19, 2023 at 01:35:32PM +0000, Parav Pandit wrote:
> 
> > From: Cornelia Huck <cohuck@redhat.com>
> > Sent: Wednesday, April 19, 2023 9:33 AM
> > 
> > On Tue, Apr 11 2023, Parav Pandit <parav@nvidia.com> wrote:
> > 
> > > Queue is a verb and noun both. Replacing it with enqueue avoids
> > > ambiguity around plural queues noun vs verb; similar to virtio fs
> > > device description.
> > 
> > Personally, I don't think this patch adds much, but I don't really mind it, either.
> > 
> > >
> > > Suggested-by: Michael S. Tsirkin <mst@redhat.com>
> > > Signed-off-by: Parav Pandit <parav@nvidia.com>
> > > ---
> > >  device-types/blk/description.tex   | 2 +-
> > >  device-types/gpio/description.tex  | 4 ++--
> > >  device-types/i2c/description.tex   | 2 +-
> > >  device-types/scsi/description.tex  | 2 +-
> > > device-types/vsock/description.tex | 2 +-
> > >  5 files changed, 6 insertions(+), 6 deletions(-)
> > >
> > 
> > (...)
> > 
> > > diff --git a/device-types/vsock/description.tex
> > > b/device-types/vsock/description.tex
> > > index 105bb30..07909d6 100644
> > > --- a/device-types/vsock/description.tex
> > > +++ b/device-types/vsock/description.tex
> > > @@ -218,7 +218,7 @@ \subsubsection{Buffer Space
> > > Management}\label{sec:Device Types / Socket Device /  \field{buf_alloc} and
> > \field{fwd_cnt} fields.
> > >
> > >  \subsubsection{Receive and Transmit}\label{sec:Device Types / Socket
> > > Device / Device Operation / Receive and Transmit} -The driver queues
> > > outgoing packets on the tx virtqueue and incoming packet
> > > +The driver enqueues outgoing packets on the tx virtqueue and incoming
> > > +packet
> > 
> > "queues (...) on" reads natural to me, but I'd use "to" with "enqueues"... 
> Yes, I agree.
> The driver enqueues outgoing packets to the tx virtqueue reads better to me.

+1

> > can any
> > native speakers comment?
> > 
> > >  receive buffers on the rx virtqueue. Packets are of the following form:
> > >
> > >  \begin{lstlisting}


This publicly archived list offers a means to provide input to the
OASIS Virtual I/O Device (VIRTIO) TC.

In order to verify user consent to the Feedback License terms and
to minimize spam in the list archive, subscription is required
before posting.

Subscribe: virtio-comment-subscribe@lists.oasis-open.org
Unsubscribe: virtio-comment-unsubscribe@lists.oasis-open.org
List help: virtio-comment-help@lists.oasis-open.org
List archive: https://lists.oasis-open.org/archives/virtio-comment/
Feedback License: https://www.oasis-open.org/who/ipr/feedback_license.pdf
List Guidelines: https://www.oasis-open.org/policies-guidelines/mailing-lists
Committee: https://www.oasis-open.org/committees/virtio/
Join OASIS: https://www.oasis-open.org/join/