Linux Virtualization - Sep 2012 - [PATCH] virtio-spec: serial: english tweak

"A number of virtqueues are created" seems clearer
than "the number of virtqueues": it's
virtqueues that are created not the number.

Signed-off-by: Michael S. Tsirkin <mst at redhat.com>
---

I'm not a native english speaker but the below
seems correct to me. Rusty?

 virtio-spec.lyx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/virtio-spec.lyx b/virtio-spec.lyx
index d9626a9..a29315c 100644
--- a/virtio-spec.lyx
+++ b/virtio-spec.lyx
@@ -6406,7 +6406,7 @@ If the VIRTIO_CONSOLE_F_MULTIPORT feature is negotiated,
the driver can
  spawn multiple ports, not all of which may be attached to a console.
  Some could be generic ports.
  In this case, the control virtqueues are enabled and according to the
max_nr_po
-rts configuration-space value, the appropriate number of virtqueues are
+rts configuration-space value, an appropriate number of virtqueues are
  created.
  A control message indicating the driver is ready is sent to the host.
  The host can then send control messages for adding new ports to the device.
-- 
MST

On (Sun) 09 Sep 2012 [15:11:17], Michael S. Tsirkin
wrote:
> "A number of virtqueues are created" seems clearer
> than "the number of virtqueues": it's
> virtqueues that are created not the number.
> 
> Signed-off-by: Michael S. Tsirkin <mst at redhat.com>
Acked-by: Amit Shah <amit.shah at redhat.com>

		Amit

On Sun, Sep 09, 2012 at 03:11:16PM +0300, Michael S. Tsirkin
wrote:
> "A number of virtqueues are created" seems clearer
> than "the number of virtqueues": it's
> virtqueues that are created not the number.
> 
> Signed-off-by: Michael S. Tsirkin <mst at redhat.com>
ping
> ---
> 
> I'm not a native english speaker but the below
> seems correct to me. Rusty?
> 
>  virtio-spec.lyx | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
> 
> diff --git a/virtio-spec.lyx b/virtio-spec.lyx
> index d9626a9..a29315c 100644
> --- a/virtio-spec.lyx
> +++ b/virtio-spec.lyx
> @@ -6406,7 +6406,7 @@ If the VIRTIO_CONSOLE_F_MULTIPORT feature is
negotiated, the driver can
>   spawn multiple ports, not all of which may be attached to a console.
>   Some could be generic ports.
>   In this case, the control virtqueues are enabled and according to the
max_nr_po
> -rts configuration-space value, the appropriate number of virtqueues are
> +rts configuration-space value, an appropriate number of virtqueues are
>   created.
>   A control message indicating the driver is ready is sent to the host.
>   The host can then send control messages for adding new ports to the
device.
> -- 
> MST

----- Original Message -----
> "A number of virtqueues are created" seems clearer
> than "the number of virtqueues": it's
> virtqueues that are created not the number.
> 
> Signed-off-by: Michael S. Tsirkin <mst at redhat.com>
Acked-by: Amos Kong <akong at redhat.com>


Two opposite problem exists:

--- virtio-0.9.5.lyx.orig	2012-12-04 09:29:03.249676649 +0800
+++ virtio-0.9.5.lyx	2012-12-04 09:28:26.272678220 +0800
@@ -8685,7 +8685,7 @@ s on QueueNum, QueueAlign and QueuePFN a
 \begin_inset Newline newline
 \end_inset
 
- Queue size is a number of elements in the queue, therefore size of the
+ Queue size is the number of elements in the queue, therefore size of the
  descriptor table and both available and used rings.
 \begin_inset Newline newline
 \end_inset
@@ -8850,7 +8850,7 @@ reference "sub:Device-Initialization-Seq
 \end_layout
 
 \begin_layout Standard
-Virtual queue size is a number of elements in the queue, therefore size
+Virtual queue size is the number of elements in the queue, therefore size
  of the descriptor table and both available and used rings.
 \end_layout
 

> ---
> 
> I'm not a native english speaker but the below
> seems correct to me. Rusty?
> 
>  virtio-spec.lyx | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
> 
> diff --git a/virtio-spec.lyx b/virtio-spec.lyx
> index d9626a9..a29315c 100644
> --- a/virtio-spec.lyx
> +++ b/virtio-spec.lyx
> @@ -6406,7 +6406,7 @@ If the VIRTIO_CONSOLE_F_MULTIPORT feature is
> negotiated, the driver can
>   spawn multiple ports, not all of which may be attached to a
>   console.
>   Some could be generic ports.
>   In this case, the control virtqueues are enabled and according to
>   the max_nr_po
> -rts configuration-space value, the appropriate number of virtqueues
> are
> +rts configuration-space value, an appropriate number of virtqueues
> are
>   created.
>   A control message indicating the driver is ready is sent to the
>   host.
>   The host can then send control messages for adding new ports to the
>   device.
> --
> MST
> _______________________________________________
> Virtualization mailing list
> Virtualization at lists.linux-foundation.org
> https://lists.linuxfoundation.org/mailman/listinfo/virtualization
>

"Michael S. Tsirkin" <mst at redhat.com>
writes:
> "A number of virtqueues are created" seems clearer
> than "the number of virtqueues": it's
> virtqueues that are created not the number.
"the appropriate number" <- there is only one appropriate number.
"an appropriate number" <- there is at least one appropriate
number.

If it's a specified number, the former is more precise.

Cheers,
Rusty.