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

 


Help: OASIS Mailing Lists Help | MarkMail Help

virtio message

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


Subject: [OASIS Issue Tracker] (VIRTIO-89) VIRTIO Spec feedback #7 From: Arun Subbarao


     [ https://tools.oasis-open.org/issues/browse/VIRTIO-89?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Michael Tsirkin updated VIRTIO-89:
----------------------------------

    Affects Version/s: virtio 1.0 csprd01
        Fix Version/s: virtio 1.0 csprd02

> VIRTIO Spec feedback  #7 From: Arun Subbarao
> --------------------------------------------
>
>                 Key: VIRTIO-89
>                 URL: https://tools.oasis-open.org/issues/browse/VIRTIO-89
>             Project: OASIS Virtual I/O Device (VIRTIO) TC
>          Issue Type: Bug
>    Affects Versions: virtio 1.0 csprd01
>            Reporter: Michael Tsirkin
>             Fix For: virtio 1.0 csprd02
>
>
> Link to Mail: https://lists.oasis-open.org/archives/virtio-comment/201401/msg00058.html
> Commenter name: Arun Subbarao <asubbarao@lnxw.com>
> (PARTIAL: there is more feedback)
> The lack of any kind of distinguishing emphasis used consistently with field names in this document makes it hard to read. For example, here, is it literally the next field or the field called "next"? Because there is a field called "next" defined by this spec. This made me scroll back to the used ring definition to refresh the meaning of field "next" in my head, only to realize there is no such field in that particular structure. You are not kind to the reader.
> If you search for the field name "avail_event", you will see that sometimes it is emphasized with quotes and sometimes it isn't. Probably better to use a monospace font instead.



--
This message was sent by Atlassian JIRA
(v6.1.1#6155)


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