On Wed, Apr 05, 2023 at 01:02:24PM +0000, Parav Pandit wrote:
>
>
> > From: Michael S. Tsirkin <m...@redhat.com>
> > Sent: Wednesday, April 5, 2023 5:18 AM
>
> > following format for \field{command-specific-data}:
> > > \begin{lstlisting}
> > > +struct rss_rq_id {
> > > + le16 vqn_1_16: 15; /* Bits 1 to 16 of the vq index */
> >
> > Do you want to then call this vq_index_1_16 ?
> Yes. will change.
>
> > And in the comment I would just write virtqueue index.
> >
> Why do you prefer longer to name here instead of abbreviation?
Eschew abbreviation is standard advice for writers.
Full names reduce the cognitive load - reader has less terms to
remember to be able to understand the spec.
--
MST
---------------------------------------------------------------------
To unsubscribe, e-mail: virtio-dev-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: virtio-dev-h...@lists.oasis-open.org
