[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: [OASIS Issue Tracker] Updated: (VIRTIO-70) 2.1 Device Status Field - Confused Language
[ http://tools.oasis-open.org/issues/browse/VIRTIO-70?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Michael Tsirkin updated VIRTIO-70:
----------------------------------
Description:
2.1 Device Status Field reads in part:
*****
The driver MUST update the Device Status field in the order below to indicate its progress.
*****
The antecedent of "its" is unclear.
I am assuming "its progress" refers to the Device and not the driver. But as written, it could be either one.
If Device, suggest: "A driver MUST update the Device Status field to indicate the state of its device."
Reasoning that a Device Status field belongs to a particular device and that is the field that should be updated.
BTW, I said "A driver" because we are talking about any driver and not some driver in particular.
was:
2.1 Device Status Field reads in part:
*****
The driver MUST update the Device Status field in the order below to indicate its progress.
*****
The antecedent of "its" is unclear.
I am assuming "its progress" refers to the Device and not the driver. But as written, it could be either one.
If Device, suggest: "A driver MUST update the Device Status field to indicate the state of its device."
Reasoning that a Device Status field belongs to a particular device and that is the field that should be updated.
BTW, I said "A driver" because we are talking about any driver and not some driver in particular.
Proposal: 1393200538-7434-1-git-send-email-mst@redhat.com">http://mid.gmane.org/1393200538-7434-1-git-send-email-mst@redhat.com (was: "A driver MUST update the Device Status field to indicate the state of its device.")
> 2.1 Device Status Field - Confused Language
> -------------------------------------------
>
> Key: VIRTIO-70
> URL: http://tools.oasis-open.org/issues/browse/VIRTIO-70
> Project: OASIS Virtual I/O Device (VIRTIO) TC
> Issue Type: Bug
> Reporter: Patrick Durusau
> Assignee: Michael Tsirkin
> Priority: Trivial
>
> 2.1 Device Status Field reads in part:
> *****
> The driver MUST update the Device Status field in the order below to indicate its progress.
> *****
> The antecedent of "its" is unclear.
> I am assuming "its progress" refers to the Device and not the driver. But as written, it could be either one.
> If Device, suggest: "A driver MUST update the Device Status field to indicate the state of its device."
> Reasoning that a Device Status field belongs to a particular device and that is the field that should be updated.
> BTW, I said "A driver" because we are talking about any driver and not some driver in particular.
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://tools.oasis-open.org/issues/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]