[PATCH v3 0/6] rework notifications terminology

From
Halil Pasic <>
Date
2018-06-25T15:16:00+00:00
ID
Thread
[PATCH v3 0/6] rework notifications terminology
On 06/25/2018 04:45 PM, Cornelia Huck wrote:
On Mon, 25 Jun 2018 14:21:27 +0200 Halil Pasic <> wrote:
Let us unify the wording when talking about notifications. This change establishes the terms available buffer notification for what was usually
[..]
Device reports the number of bytes it has written to memory for
each buffer it uses. This is referred to as ``used length''.
Unrelated: Device and driver are missing the definite article in some places. Might be an idea for an additional patch :)
Yes, there are definitively other things that could be improved. For example the capitalization in listing:  egin{itemize} item Device status field item Feature bits item Notifications item Device Configuration space  Capital C in *C*onfiguration is most likely wrong.  item One or more virtqueues end{itemize}  Regarding bullet points and capitalization, if the bullet point is not a sentence but a fragment there seems to be multiple viable styles. But I'm afraid we aren't consequent across the spec.  Another question is capitalization of 'virtio terms' like Available Ring. On some occasions we write 'Available Ring' on others 'available ring'.  It would be nice to have a polished document. But for now I will try to target fragments where the semantics suffers too. (I had another series that I already presented as RFC but decided to not push in parallel with this one).
Reviewed-by: Cornelia Huck <>
Thanks!  Regards, Halil