Skip to contentSkip to conversation

Subject: docs: disk-utils: change "allows to <verb>" to "allows <verb>ing"

PATCH Applied Bjarni Ingi Gislason 3 participants 3 messages Jul 10, 2020 – Jul 14, 2020 Util-Linux package

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 Subject: docs: disk-utils: change "allows to <verb>" to "allows <verb>ing"

The web site "lintian.debian.org" shows some examples of "allows to",
which are changed to "allows one to".

I chose here to use gerund.

---
 disk-utils/fdisk.8     | 2 +-
 disk-utils/sfdisk.8    | 6 +++---
 disk-utils/swaplabel.8 | 2 +-
 3 files changed, 5 insertions(+), 5 deletions(-)
disk-utils/fdisk.8 +1 -1
index f683bcaaa..8780a7419 100644
@@ -200,7 +200,7 @@ are deprecated.
 
 .SH SCRIPT FILES
 .B fdisk
-allows to read (by 'I' command) sfdisk compatible script files. The script is
+allows reading (by 'I' command) sfdisk compatible script files. The script is
 applied to in-memory partition table, and then it is possible to modify the
 partition table before you write it to the device.
 .PP
disk-utils/sfdisk.8 +3 -3
index 6c278afb6..38a674853 100644
@@ -295,7 +295,7 @@ disk label (see the \fBEMPTY DISK LABEL\fR section below).
 .TP
 .BR \-Y , " \-\-label\-nested " \fItype
 Force editing of a nested disk label.  The primary disk label has to exist already.
-This option allows to edit for example a hybrid/protective MBR on devices with GPT.
+This option allows editing for example a hybrid/protective MBR on devices with GPT.
 
 .TP
 .BR \-w , " \-\-wipe "\fIwhen
@@ -469,7 +469,7 @@ loaders and for other operating systems.
 
 .B Named-fields format
 .RS
-This format is more readable, robust, extensible and allows to specify additional
+This format is more readable, robust, extensible and allows specifying additional
 information (e.g., a UUID).  It is recommended to use this format to keep your scripts
 more readable.
 .RS
@@ -480,7 +480,7 @@ more readable.
 The
 .I device
 field is optional.  \fBsfdisk\fR extracts the partition number from the
-device name.  It allows to specify the partitions in random order.
+device name.  It allows specifying the partitions in random order.
 This functionality is mostly used by \fB\-\-dump\fR.
 Don't use it if you are not sure.
 
disk-utils/swaplabel.8 +1 -1
index b623a5020..c92de00a5 100644
@@ -35,7 +35,7 @@ These values can also be set during swap creation using
 .BR mkswap (8).
 The
 .B swaplabel
-utility allows to change the label or UUID on an actively used swap device.
+utility allows changing the label or UUID on an actively used swap device.
 .SH OPTIONS
 .TP
 .BR \-h , " \-\-help"
Signature · 1 line
2.27.0
Acked-by on v1 1/1
#1 lore raw
Quoted 6 lines · Bjarni Ingi Gislason

The web site "lintian.debian.org" shows some examples of "allows to",
which are changed to "allows one to".

I chose here to use gerund.

LGTM. Thanks.

Quoted 64 lines
---
 disk-utils/fdisk.8     | 2 +-
 disk-utils/sfdisk.8    | 6 +++---
 disk-utils/swaplabel.8 | 2 +-
 3 files changed, 5 insertions(+), 5 deletions(-)
disk-utils/fdisk.8 +1 -1
index f683bcaaa..8780a7419 100644
@@ -200,7 +200,7 @@ are deprecated.
 
 .SH SCRIPT FILES
 .B fdisk
-allows to read (by 'I' command) sfdisk compatible script files. The script is
+allows reading (by 'I' command) sfdisk compatible script files. The script is
 applied to in-memory partition table, and then it is possible to modify the
 partition table before you write it to the device.
 .PP
disk-utils/sfdisk.8 +3 -3
index 6c278afb6..38a674853 100644
@@ -295,7 +295,7 @@ disk label (see the \fBEMPTY DISK LABEL\fR section below).
 .TP
 .BR \-Y , " \-\-label\-nested " \fItype
 Force editing of a nested disk label.  The primary disk label has to exist already.
-This option allows to edit for example a hybrid/protective MBR on devices with GPT.
+This option allows editing for example a hybrid/protective MBR on devices with GPT.
 
 .TP
 .BR \-w , " \-\-wipe "\fIwhen
@@ -469,7 +469,7 @@ loaders and for other operating systems.
 
 .B Named-fields format
 .RS
-This format is more readable, robust, extensible and allows to specify additional
+This format is more readable, robust, extensible and allows specifying additional
 information (e.g., a UUID).  It is recommended to use this format to keep your scripts
 more readable.
 .RS
@@ -480,7 +480,7 @@ more readable.
 The
 .I device
 field is optional.  \fBsfdisk\fR extracts the partition number from the
-device name.  It allows to specify the partitions in random order.
+device name.  It allows specifying the partitions in random order.
 This functionality is mostly used by \fB\-\-dump\fR.
 Don't use it if you are not sure.
 
disk-utils/swaplabel.8 +1 -1
index b623a5020..c92de00a5 100644
@@ -35,7 +35,7 @@ These values can also be set during swap creation using
 .BR mkswap (8).
 The
 .B swaplabel
-utility allows to change the label or UUID on an actively used swap device.
+utility allows changing the label or UUID on an actively used swap device.
 .SH OPTIONS
 .TP
 .BR \-h , " \-\-help"
Signature · 1 line
~Randy
maintainer Applied
#2 lore raw
In reply to Bjarni Ingi Gislason
Quoted 4 lines · Bjarni Ingi Gislason
 disk-utils/fdisk.8     | 2 +-
 disk-utils/sfdisk.8    | 6 +++---
 disk-utils/swaplabel.8 | 2 +-
 3 files changed, 5 insertions(+), 5 deletions(-)

Applied, thanks.

Signature · 2 lines
 Karel Zak  <[email protected]>
 http://karelzak.blogspot.com