Commit 9d85d557 authored by Michael Tokarev's avatar Michael Tokarev
Browse files

doc: grammify "allows to" 



English language grammar does not allow usage
of the word "allows" directly followed by an
infinitive, declaring constructs like "something
allows to do somestuff" un-grammatical.  Often
it is possible to just insert "one" between "allows"
and "to" to make the construct grammatical, but
usually it is better to re-phrase the statement.

This patch tries to fix 4 examples of "allows to"
usage in qemu doc, but does not address comments
in the code with similar constructs.  It also adds
missing "the" in the same line.

Signed-off-by: default avatarMichael Tokarev <mjt@tls.msk.ru>
parent 2300aed1

qemu-doc.texi

+1 −1
Original line number Diff line number Diff line
@@ -823,7 +823,7 @@ In this case, the block device must be exported using qemu-nbd: 
qemu-nbd --socket=/tmp/my_socket my_disk.qcow2

@end example



The use of qemu-nbd allows to share a disk between several guests:

The use of qemu-nbd allows sharing of a disk between several guests:

@example

qemu-nbd --socket=/tmp/my_socket --share=2 my_disk.qcow2

@end example

qemu-options.hx

+4 −3
Original line number Diff line number Diff line
@@ -444,7 +444,8 @@ This option defines the type of the media: disk or cdrom. 
@item cyls=@var{c},heads=@var{h},secs=@var{s}[,trans=@var{t}]

These options have the same definition as they have in @option{-hdachs}.

@item snapshot=@var{snapshot}

@var{snapshot} is "on" or "off" and allows to enable snapshot for given drive (see @option{-snapshot}).

@var{snapshot} is "on" or "off" and controls snapshot mode for the given drive

(see @option{-snapshot}).

@item cache=@var{cache}

@var{cache} is "none", "writeback", "unsafe", "directsync" or "writethrough" and controls how the host cache is used to access block data.

@item aio=@var{aio}
@@ -1242,7 +1243,7 @@ Disable adaptive encodings. Adaptive encodings are enabled by default. 
An adaptive encoding will try to detect frequently updated screen regions,

and send updates in these regions using a lossy encoding (like JPEG).

This can be really helpful to save bandwidth when playing videos. Disabling

adaptive encodings allows to restore the original static behavior of encodings

adaptive encodings restores the original static behavior of encodings

like Tight.



@item share=[allow-exclusive|force-shared|ignore]
@@ -2805,7 +2806,7 @@ UTC or local time, respectively. @code{localtime} is required for correct date i 
MS-DOS or Windows. To start at a specific point in time, provide @var{date} in the

format @code{2006-06-17T16:01:21} or @code{2006-06-17}. The default base is UTC.



By default the RTC is driven by the host system time. This allows to use the

By default the RTC is driven by the host system time. This allows using of the

RTC as accurate reference clock inside the guest, specifically if the host

time is smoothly following an accurate external reference clock, e.g. via NTP.

If you want to isolate the guest time from the host, you can set @option{clock}