From 29e204d117a1c4025c71380f9c92692cb15e9d70 Mon Sep 17 00:00:00 2001
From: Karel Zak <kzak@redhat.com>
Date: Tue, 14 Jul 2020 14:31:29 +0200
Subject: [PATCH] docs: reword others "allow to"

Signed-off-by: Karel Zak <kzak@redhat.com>
---
 Documentation/TODO                    |  2 +-
 lib/loopdev.c                         |  2 +-
 libblkid/src/partitions/partitions.c  |  4 ++--
 libblkid/src/partitions/solaris_x86.c |  2 +-
 libblkid/src/probe.c                  |  4 ++--
 libfdisk/src/ask.c                    |  6 +++---
 libfdisk/src/context.c                |  2 +-
 libfdisk/src/label.c                  |  2 +-
 libfdisk/src/partition.c              |  2 +-
 libfdisk/src/script.c                 |  6 +++---
 libmount/src/cache.c                  |  2 +-
 libmount/src/context.c                | 10 +++++-----
 libmount/src/context_mount.c          |  6 +++---
 libmount/src/context_umount.c         |  2 +-
 libsmartcols/src/column.c             |  2 +-
 libsmartcols/src/grouping.c           |  2 +-
 libsmartcols/src/symbols.c            |  2 +-
 login-utils/login.c                   |  2 +-
 sys-utils/adjtime_config.5            |  2 +-
 sys-utils/dmesg.c                     |  4 ++--
 20 files changed, 33 insertions(+), 33 deletions(-)

diff --git a/Documentation/TODO b/Documentation/TODO
index 4172649a2..3098076c9 100644
--- a/Documentation/TODO
+++ b/Documentation/TODO
@@ -77,7 +77,7 @@ libmount (mount/umount)
    loop devices, write to /run/mount/utab or /etc/mtab, etc.
 
    It would be nice to improve libmount to check for CAP_SYS_ADMIN if suid not
-   set and allow to use it for simple tasks where no another operation is
+   set and allow using it for simple tasks where no another operation is
    necessary.
 
 partx
diff --git a/lib/loopdev.c b/lib/loopdev.c
index ef22a9d87..1581f9cc2 100644
--- a/lib/loopdev.c
+++ b/lib/loopdev.c
@@ -299,7 +299,7 @@ int loopcxt_set_fd(struct loopdev_cxt *lc, int fd, int mode)
  * @lc: context
  * @flags: LOOPITER_FL_* flags
  *
- * Iterator allows to scan list of the free or used loop devices.
+ * Iterator can be used to scan list of the free or used loop devices.
  *
  * Returns: <0 on error, 0 on success
  */
diff --git a/libblkid/src/partitions/partitions.c b/libblkid/src/partitions/partitions.c
index 5bbf45cf1..e0a1ee170 100644
--- a/libblkid/src/partitions/partitions.c
+++ b/libblkid/src/partitions/partitions.c
@@ -466,7 +466,7 @@ blkid_partition blkid_partlist_add_partition(blkid_partlist ls,
 	return par;
 }
 
-/* allows to modify used partitions numbers (for example for logical partitions) */
+/* can be used to modify used partitions numbers (for example for logical partitions) */
 int blkid_partlist_set_partno(blkid_partlist ls, int partno)
 {
 	if (!ls)
@@ -480,7 +480,7 @@ int blkid_partlist_increment_partno(blkid_partlist ls)
 	return ls ? ls->next_partno++ : -1;
 }
 
-/* allows to set "parent" for the next nested partition */
+/* can be used to set "parent" for the next nested partition */
 static int blkid_partlist_set_parent(blkid_partlist ls, blkid_partition par)
 {
 	if (!ls)
diff --git a/libblkid/src/partitions/solaris_x86.c b/libblkid/src/partitions/solaris_x86.c
index 1eb27a97e..df1def57a 100644
--- a/libblkid/src/partitions/solaris_x86.c
+++ b/libblkid/src/partitions/solaris_x86.c
@@ -15,7 +15,7 @@
 
 /*
  * Solaris-x86 is always within primary dos partition (nested PT table).  The
- * solaris-x86 vtoc allows to split the entire partition to "slices". The
+ * solaris-x86 vtoc can be used to split the entire partition to "slices". The
  * offset (start) of the slice is always relatively to the primary dos
  * partition.
  *
diff --git a/libblkid/src/probe.c b/libblkid/src/probe.c
index 9f116f15c..8f5f59da3 100644
--- a/libblkid/src/probe.c
+++ b/libblkid/src/probe.c
@@ -1956,8 +1956,8 @@ size_t blkid_ltrim_whitespace(unsigned char *str)
  * wiped area then the signature has been added later and LVM superblock
  * should be ignore.
  *
- * Note that this heuristic is not 100% reliable, for example "pvcreate --zero
- * n" allows to keep the begin of the device unmodified. It's probably better
+ * Note that this heuristic is not 100% reliable, for example "pvcreate --zero n"
+ * can be used to keep the begin of the device unmodified. It's probably better
  * to use this heuristic for conflicts between superblocks and partition tables
  * than for conflicts between filesystem superblocks -- existence of unwanted
  * partition table is very unusual, because PT is pretty visible (parsed and
diff --git a/libfdisk/src/ask.c b/libfdisk/src/ask.c
index 9fabc99c8..31f95fb06 100644
--- a/libfdisk/src/ask.c
+++ b/libfdisk/src/ask.c
@@ -323,7 +323,7 @@ int fdisk_ask_number_is_relative(struct fdisk_ask *ask)
  * fdisk_ask_number_is_wrap_negative:
  * @ask: ask instance
  *
- * The wrap-negative flag allows to accept negative number from user. In this
+ * The wrap-negative flag can be used to accept negative number from user. In this
  * case the dialog result is calculated as "high - num" (-N from high limit).
  *
  * Returns: 1 or 0.
@@ -342,8 +342,8 @@ int fdisk_ask_number_is_wrap_negative(struct fdisk_ask *ask)
  * @ask: ask instance
  * @relative: 0 or 1
  *
- * Inform libfdisk that user specified number in relative notation rather than
- * by explicit number. This info allows to fdisk do some optimization (e.g.
+ * Inform libfdisk that user can specify the number in relative notation rather than
+ * by explicit number. This is useful for some optimization (e.g.
  * align end of partition, etc.)
  *
  * Returns: 0 on success, <0 on error
diff --git a/libfdisk/src/context.c b/libfdisk/src/context.c
index 8eb12271c..78ca951ac 100644
--- a/libfdisk/src/context.c
+++ b/libfdisk/src/context.c
@@ -335,7 +335,7 @@ int fdisk_has_protected_bootbits(struct fdisk_context *cxt)
  * @enable: 1 or 0
  *
  * The library zeroizes all the first sector when create a new disk label by
- * default.  This function allows to control this behavior. For now it's
+ * default.  This function can be used to control this behavior. For now it's
  * supported for MBR and GPT.
  *
  * Returns: 0 on success, < 0 on error.
diff --git a/libfdisk/src/label.c b/libfdisk/src/label.c
index 186df4880..5c945a9cc 100644
--- a/libfdisk/src/label.c
+++ b/libfdisk/src/label.c
@@ -8,7 +8,7 @@
  * @short_description: disk label (PT) specific data and functions
  *
  * The fdisk_new_context() initializes all label drivers, and allocate
- * per-label specific data struct. This concept allows to store label specific
+ * per-label specific data struct. This concept can be used to store label specific
  * settings to the label driver independently on the currently active label
  * driver. Note that label struct cannot be deallocated, so there is no
  * reference counting for fdisk_label objects. All is destroyed by
diff --git a/libfdisk/src/partition.c b/libfdisk/src/partition.c
index ae07882e6..46fddc524 100644
--- a/libfdisk/src/partition.c
+++ b/libfdisk/src/partition.c
@@ -1175,7 +1175,7 @@ static int recount_resize(
 	rc = fdisk_get_partitions(cxt, &tb);
 	if (!rc) {
 		/* For resize we do not follow grain to detect free-space, but
-		 * we allow to resize with very small granulation. */
+		 * we support to resize with very small granulation. */
 		unsigned long org = cxt->grain;
 
 		cxt->grain = cxt->sector_size;
diff --git a/libfdisk/src/script.c b/libfdisk/src/script.c
index 8af2e54cd..ede6ab84b 100644
--- a/libfdisk/src/script.c
+++ b/libfdisk/src/script.c
@@ -9,7 +9,7 @@
  * @title: Script
  * @short_description: complex way to create and dump partition table
  *
- * This interface allows to compose in-memory partition table with all details,
+ * This interface can be used to compose in-memory partition table with all details,
  * write all partition table description to human readable text file, read it
  * from the file, and apply the script to on-disk label.
  *
@@ -268,7 +268,7 @@ const char *fdisk_script_get_header(struct fdisk_script *dp, const char *name)
  * If no @data is specified then the header is removed. If header does not exist
  * and @data is specified then a new header is added.
  *
- * Note that libfdisk allows to specify arbitrary custom header, the default
+ * Note that libfdisk can be used to specify arbitrary custom header, the default
  * built-in headers are "unit" and "label", and some label specific headers
  * (for example "uuid" and "name" for GPT).
  *
@@ -362,7 +362,7 @@ struct fdisk_table *fdisk_script_get_table(struct fdisk_script *dp)
  * @tb: table
  *
  * Replaces table used by script and creates a new reference to @tb. This
- * function allows to generate a new script table independently on the current
+ * function can be used to generate a new script table independently on the current
  * context and without any file reading.
  *
  * This is useful for example to create partition table with the same basic
diff --git a/libmount/src/cache.c b/libmount/src/cache.c
index 0e76891b8..2fafdd0fa 100644
--- a/libmount/src/cache.c
+++ b/libmount/src/cache.c
@@ -153,7 +153,7 @@ void mnt_unref_cache(struct libmnt_cache *cache)
  * @cache: cache pointer
  * @mtab: table with already canonicalized mountpoints
  *
- * Add to @cache reference to @mtab. This allows to avoid unnecessary paths
+ * Add to @cache reference to @mtab. This can be used to avoid unnecessary paths
  * canonicalization in mnt_resolve_target().
  *
  * Returns: negative number in case of error, or 0 o success.
diff --git a/libmount/src/context.c b/libmount/src/context.c
index 7d4370d35..6196c7156 100644
--- a/libmount/src/context.c
+++ b/libmount/src/context.c
@@ -900,7 +900,7 @@ int mnt_context_is_loopdel(struct libmnt_context *cxt)
  * @cxt: mount context
  * @fs: filesystem description
  *
- * The mount context uses private @fs by default. This function allows to
+ * The mount context uses private @fs by default. This function can be used to
  * overwrite the private @fs with an external instance. This function
  * increments @fs reference counter (and decrement reference counter of the
  * old fs).
@@ -1190,7 +1190,7 @@ int mnt_context_set_options_pattern(struct libmnt_context *cxt, const char *patt
  * @tb: fstab
  *
  * The mount context reads /etc/fstab to the private struct libmnt_table by default.
- * This function allows to overwrite the private fstab with an external
+ * This function can be used to overwrite the private fstab with an external
  * instance.
  *
  * This function modify the @tb reference counter. This function does not set
@@ -1493,7 +1493,7 @@ int mnt_context_set_tables_errcb(struct libmnt_context *cxt,
  * @cache: cache instance or NULL
  *
  * The mount context maintains a private struct libmnt_cache by default. This
- * function allows to overwrite the private cache with an external instance.
+ * function can be used to overwrite the private cache with an external instance.
  * This function increments cache reference counter.
  *
  * If the @cache argument is NULL, then the current cache instance is reset.
@@ -1611,7 +1611,7 @@ struct libmnt_lock *mnt_context_get_lock(struct libmnt_context *cxt)
  *
  * Sets mount flags (see mount(2) man page).
  *
- * Note that mount context allows to define mount options by mount flags. It
+ * Note that mount context can be used to define mount options by mount flags. It
  * means you can for example use
  *
  *	mnt_context_set_mflags(cxt, MS_NOEXEC | MS_NOSUID);
@@ -1740,7 +1740,7 @@ int mnt_context_get_user_mflags(struct libmnt_context *cxt, unsigned long *flags
  * @data: mount(2) data
  *
  * The mount context generates mountdata from mount options by default. This
- * function allows to overwrite this behavior, and @data will be used instead
+ * function can be used to overwrite this behavior, and @data will be used instead
  * of mount options.
  *
  * The libmount does not deallocate the data by mnt_free_context(). Note that
diff --git a/libmount/src/context_mount.c b/libmount/src/context_mount.c
index c00e73261..e0ef550b0 100644
--- a/libmount/src/context_mount.c
+++ b/libmount/src/context_mount.c
@@ -293,8 +293,8 @@ static int fix_optstr(struct libmnt_context *cxt)
 		se_rem = 1;
 	else if (cxt->mountflags & MS_REMOUNT)
 		/*
-		 * Linux kernel < 2.6.39 does not allow to remount with any
-		 * selinux specific mount options.
+		 * Linux kernel < 2.6.39 does not support remount operation
+		 * with any selinux specific mount options.
 		 *
 		 * Kernel 2.6.39 commits:  ff36fe2c845cab2102e4826c1ffa0a6ebf487c65
 		 *                         026eb167ae77244458fa4b4b9fc171209c079ba7
@@ -1080,7 +1080,7 @@ int mnt_context_do_mount(struct libmnt_context *cxt)
 		/*
 		 * Mounted by mount(2), do some post-mount checks
 		 *
-		 * Kernel allows to use MS_RDONLY for bind mounts, but the
+		 * Kernel can be used to use MS_RDONLY for bind mounts, but the
 		 * read-only request could be silently ignored. Check it to
 		 * avoid 'ro' in mtab and 'rw' in /proc/mounts.
 		 */
diff --git a/libmount/src/context_umount.c b/libmount/src/context_umount.c
index f33b62644..df9a2ebf5 100644
--- a/libmount/src/context_umount.c
+++ b/libmount/src/context_umount.c
@@ -64,7 +64,7 @@ static int __mtab_find_umount_fs(struct libmnt_context *cxt,
 	/*
 	 * The mount table may be huge, and on systems with utab we have to
 	 * merge userspace mount options into /proc/self/mountinfo. This all is
-	 * expensive. The tab filter allows to filter out entries, then a mount
+	 * expensive. The tab filter can be used to filter out entries, then a mount
 	 * table and utab are very tiny files.
 	 *
 	 * The filter uses mnt_fs_streq_{target,srcpath} function where all
diff --git a/libsmartcols/src/column.c b/libsmartcols/src/column.c
index f95264b36..c11df69f5 100644
--- a/libsmartcols/src/column.c
+++ b/libsmartcols/src/column.c
@@ -383,7 +383,7 @@ int scols_column_set_cmpfunc(struct libscols_column *cl,
  * @wrap_nextchunk: function to return next zero terminated data
  * @userdata: optional stuff for callbacks
  *
- * Extends SCOLS_FL_WRAP and allows to set custom wrap function. The default
+ * Extends SCOLS_FL_WRAP and can be used to set custom wrap function. The default
  * is to wrap by column size, but you can create functions to wrap for example
  * after \n or after words, etc.
  *
diff --git a/libsmartcols/src/grouping.c b/libsmartcols/src/grouping.c
index d0544efd8..0b27cb2e4 100644
--- a/libsmartcols/src/grouping.c
+++ b/libsmartcols/src/grouping.c
@@ -8,7 +8,7 @@
  * @title: Grouping
  * @short_description: lines grouing
  *
- * Lines groups manipulation API. The grouping API allows to create M:N
+ * Lines groups manipulation API. The grouping API can be used to create M:N
  * relations between lines and on tree-like output it prints extra chart to
  * visualize these relations. The group has unlimited number of members and
  * group childs. See libsmartcols/sample/grouping* for more details.
diff --git a/libsmartcols/src/symbols.c b/libsmartcols/src/symbols.c
index a78489844..2fadfc7ad 100644
--- a/libsmartcols/src/symbols.c
+++ b/libsmartcols/src/symbols.c
@@ -11,7 +11,7 @@
 /**
  * SECTION: symbols
  * @title: Symbols
- * @short_description: allows to overwrite default output chars (for ascii art)
+ * @short_description: can be used to overwrite default output chars (for ascii art)
  *
  * An API to access and modify data and information per symbol/symbol group.
  */
diff --git a/login-utils/login.c b/login-utils/login.c
index 3f9400184..186a5ff5e 100644
--- a/login-utils/login.c
+++ b/login-utils/login.c
@@ -199,7 +199,7 @@ static void timedout(int sig __attribute__ ((__unused__)))
 }
 
 /*
- * This handler allows to inform a shell about signals to login. If you have
+ * This handler can be used to inform a shell about signals to login. If you have
  * (root) permissions, you can kill all login children by one signal to the
  * login process.
  *
diff --git a/sys-utils/adjtime_config.5 b/sys-utils/adjtime_config.5
index f78b40f36..8085b49e0 100644
--- a/sys-utils/adjtime_config.5
+++ b/sys-utils/adjtime_config.5
@@ -13,7 +13,7 @@ The file is usually located in /etc, but tools like
 .BR hwclock (8)
 or
 .BR rtcwake (8)
-allow to use alternative location by command line options if write access to
+can use alternative location by command line options if write access to
 /etc is unwanted.  The default clock mode is "UTC" if the file is missing.
 .PP
 The Hardware Clock is usually not very accurate.  However, much of its inaccuracy is completely predictable - it gains
diff --git a/sys-utils/dmesg.c b/sys-utils/dmesg.c
index c8ac3c1b8..c7759857e 100644
--- a/sys-utils/dmesg.c
+++ b/sys-utils/dmesg.c
@@ -1133,8 +1133,8 @@ static int init_kmsg(struct dmesg_control *ctl)
 	lseek(ctl->kmsg, 0, ctl->end ? SEEK_END : SEEK_DATA);
 
 	/*
-	 * Old kernels (<3.5) allow to successfully open /dev/kmsg for
-	 * read-only, but read() returns -EINVAL :-(((
+	 * Old kernels (<3.5) can successfully open /dev/kmsg for read-only,
+	 * but read() returns -EINVAL :-(((
 	 *
 	 * Let's try to read the first record. The record is later processed in
 	 * read_kmsg().