From nobody Fri Apr 26 00:23:10 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zoho.com: domain of redhat.com designates 209.132.183.28 as permitted sender) client-ip=209.132.183.28; envelope-from=libvir-list-bounces@redhat.com; helo=mx1.redhat.com; Authentication-Results: mx.zohomail.com; spf=pass (zoho.com: domain of redhat.com designates 209.132.183.28 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1555340064; cv=none; d=zoho.com; s=zohoarc; b=HppFSaBU+CTAJ5Kbl/FwvTGg6AkXQCQTTze24PBLqP0m8LfpvTorkk1hilZVx+8wn31X9DJFXB8+UGV7n7XXWNBf023zao0BMaOX4PF/t1KYBr22KoNsxq1jGbORUdJ7E0l8epI4FRlLFzaSX+d4mZN8a2r2sb21QYDordMGxhM= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zoho.com; s=zohoarc; t=1555340064; h=Content-Type:Content-Transfer-Encoding:Date:From:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:To:ARC-Authentication-Results; bh=Dtufm/yHFhlmbWrGOw53fxcBARdcqk7omeF8ohEnE9Y=; b=J4sS6vh+P1sAwLuv1BOTOAZrD22XdLraMxD7HYFyFtRKi4szuX0Z013nPhykgN1zGa+LHfVXU5mMyX+cpE2GTstoxtDzkrVkm7L0tL8XnDFtDL43Y/aqeTLqrYIyT5HueD/+94nB5g4l2QjjaLRT5DYbpEsDmBpFnLc9Jcx3hqE= ARC-Authentication-Results: i=1; mx.zoho.com; spf=pass (zoho.com: domain of redhat.com designates 209.132.183.28 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from mx1.redhat.com (mx1.redhat.com [209.132.183.28]) by mx.zohomail.com with SMTPS id 1555340064501139.98367214007897; Mon, 15 Apr 2019 07:54:24 -0700 (PDT) Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.phx2.redhat.com [10.5.11.13]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id 8762D3087930; Mon, 15 Apr 2019 14:54:22 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.21]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 5D888608C0; Mon, 15 Apr 2019 14:54:22 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id 1BF203FA46; Mon, 15 Apr 2019 14:54:22 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx07.intmail.prod.int.phx2.redhat.com [10.5.11.22]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id x3FEs7Te021694 for ; Mon, 15 Apr 2019 10:54:07 -0400 Received: by smtp.corp.redhat.com (Postfix) id E1296108F83F; Mon, 15 Apr 2019 14:54:07 +0000 (UTC) Received: from kinshicho.redhat.com (ovpn-204-220.brq.redhat.com [10.40.204.220]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 34FA1108F857 for ; Mon, 15 Apr 2019 14:54:04 +0000 (UTC) From: Andrea Bolognani To: libvir-list@redhat.com Date: Mon, 15 Apr 2019 16:54:01 +0200 Message-Id: <20190415145401.16309-1-abologna@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.84 on 10.5.11.22 X-loop: libvir-list@redhat.com Subject: [libvirt] [PATCH] tools: Fix grammar X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Transfer-Encoding: quoted-printable Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.13 X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.45]); Mon, 15 Apr 2019 14:54:23 +0000 (UTC) Content-Type: text/plain; charset="utf-8" Apparently "allow(s) to frobnicate" is not correct English, and either "allow(s) one to frobnicate" or "allow(s) frobnicating" should be used instead. Spotted by Lintian (spelling-error-in-{binary,manpage} tags). Signed-off-by: Andrea Bolognani Reviewed-by: Eric Blake --- tools/virsh-domain.c | 3 ++- tools/virsh.pod | 20 ++++++++++---------- tools/virt-admin.pod | 4 ++-- 3 files changed, 14 insertions(+), 13 deletions(-) diff --git a/tools/virsh-domain.c b/tools/virsh-domain.c index d99b9afda9..da57d96d1a 100644 --- a/tools/virsh-domain.c +++ b/tools/virsh-domain.c @@ -8313,7 +8313,8 @@ static const vshCmdInfo info_desc[] =3D { .data =3D N_("show or set domain's description or title") }, {.name =3D "desc", - .data =3D N_("Allows to show or modify description or title of a doma= in.") + .data =3D N_("Allows setting or modifying the description or title of= " + "a domain.") }, {.name =3D NULL} }; diff --git a/tools/virsh.pod b/tools/virsh.pod index 3196636825..afc1684db0 100644 --- a/tools/virsh.pod +++ b/tools/virsh.pod @@ -778,7 +778,7 @@ effect on the next boot. New description or title message] =20 Show or modify description and title of a domain. These values are user -fields that allow to store arbitrary textual data to allow easy +fields that allow storing arbitrary textual data to allow easy identification of domains. Title should be short, although it's not enforc= ed. (See also B that works with XML based domain metadata.) =20 @@ -1303,7 +1303,7 @@ within a certain range. Specifying I will c= ontrol how much data can be simultaneously in-flight during the copy; larger values use more memory= but may allow faster completion (the default value is usually correct). =20 -I<--transient-job> allows to specify that the user does not require the jo= b to +I<--transient-job> allows specifying that the user does not require the jo= b to be recovered if the VM crashes or is turned off before the job completes. = This flag removes the restriction of copy jobs to transient domains if that restriction is applied by the hypervisor. @@ -1450,9 +1450,9 @@ bytes/s. Specifying a negative value is interpreted a= s an unsigned long value or essentially unlimited. The hypervisor can choose whether to reject the value or convert it to the maximum value allowed. Optionally a scaled positive number may be used as bandwidth (see B above). Using -I<--bytes> with a scaled value allows to use finer granularity. A scaled v= alue -used without I<--bytes> will be rounded down to MiB/s. Note that the -I<--bytes> may be unsupported by the hypervisor. +I<--bytes> with a scaled value permits a finer granularity to be selected. +A scaled value used without I<--bytes> will be rounded down to MiB/s. Note +that the I<--bytes> may be unsupported by the hypervisor. =20 =20 =3Ditem B I I I @@ -1876,7 +1876,7 @@ stats. [I<--edit>] [I] [I] [I] [I<--remove>] =20 Show or modify custom XML metadata of a domain. The metadata is a user -defined XML that allows to store arbitrary XML data in the domain definiti= on. +defined XML that allows storing arbitrary XML data in the domain definitio= n. Multiple separate custom metadata pieces can be stored in the domain XML. The pieces are identified by a private XML namespace provided via the I argument. (See also B that works with textual metadata of @@ -2327,8 +2327,8 @@ either parameter is the same as not specifying that p= arameter. =3Ditem B I [I] [I<--screen> B] =20 Takes a screenshot of a current domain console and stores it into a file. -Optionally, if hypervisor supports more displays for a domain, I -allows to specify which screen will be captured. It is the sequential numb= er +Optionally, if the hypervisor supports more displays for a domain, I +allows specifying which screen will be captured. It is the sequential numb= er of screen. In case of multiple graphics cards, heads are enumerated before devices, e.g. having two graphics cards, both with four heads, screen ID 5 addresses the second head on the second card. @@ -3392,8 +3392,8 @@ expected. =20 Change media of CDROM or floppy drive. I can be the fully-qualified = path or the unique target name () of the disk device. I -specifies the path of the media to be inserted or updated. Flag I<--block> -allows to set the backing type in case a block device is used as media for= the +specifies the path of the media to be inserted or updated. The I<--block> = flag +allows setting the backing type in case a block device is used as media fo= r the CDROM or floppy drive instead of a file. =20 I<--eject> indicates the media will be ejected. diff --git a/tools/virt-admin.pod b/tools/virt-admin.pod index f06ee9247a..1ea6defa0e 100644 --- a/tools/virt-admin.pod +++ b/tools/virt-admin.pod @@ -149,8 +149,8 @@ libvirtd:///system is used. =20 =3Dhead1 DAEMON COMMANDS =20 -The following commands allow to monitor the daemon's state as well as dire= ctly -change its internal configuration. +The following commands allow one to monitor the daemon's state as well as +directly change its internal configuration. =20 =3Dover 4 =20 --=20 2.20.1 -- libvir-list mailing list libvir-list@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list