[virtio-dev] Re: [virtio-comment] [PATCH] introduction: Add missing helping verb

[Cornelia Huck <cohuck@redhat.com>]

On Tue, Apr 11 2023, Parav Pandit <parav@nvidia.com> wrote:

> The terminology of Transitional device and driver is missing the helping
> verb 'is' similar to other terminologies.
>
> Hence, add them to complete the sentence.
>
> Signed-off-by: Parav Pandit <parav@nvidia.com>
> ---
>  introduction.tex | 4 ++--
>  1 file changed, 2 insertions(+), 2 deletions(-)
>
> diff --git a/introduction.tex b/introduction.tex
> index 287c5fc..e8b34e3 100644
> --- a/introduction.tex
> +++ b/introduction.tex
> @@ -145,14 +145,14 @@ \subsection{Legacy Interface: Terminology}\label{intro:Legacy
>  
>  \begin{description}
>  \item[Transitional Device]
> -        a device supporting both drivers conforming to this
> +        is a device supporting both drivers conforming to this
>          specification, and allowing legacy drivers.
>  \end{description}
>  
>  Similarly, a driver MAY implement:
>  \begin{description}
>  \item[Transitional Driver]
> -        a driver supporting both devices conforming to this
> +        is a driver supporting both devices conforming to this
>          specification, and legacy devices.
>  \end{description}

I'd rather not add the "is" (and drop the trailing ".", as this is not
supposed to be a sentence), as this would read awkwardly. I think it is
intended to be:

<xyz> MAY implement:

<list of things>

which does not really ask for a sentence.

Same thing applies to the section right above, where it talks about
legacy support; I'd drop the "is" there instead.


---------------------------------------------------------------------
To unsubscribe, e-mail: virtio-dev-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: virtio-dev-help@lists.oasis-open.org