From 1d4505d7a1a17f9d5f91e04e2fc0e0cd5b3e4342 Mon Sep 17 00:00:00 2001 From: Simon Howard Date: Wed, 12 Mar 2025 19:17:50 +0000 Subject: [PATCH] Capitalize in various places where appropriate These are mostly acronyms (CPUs; ZILs) but also proper nouns such as "Unix" and "Unicode" which should also be capitalized. Signed-off-by: Simon Howard Reviewed-by: Tony Hutter Reviewed-by: Alexander Motin --- man/man4/spl.4 | 6 +++--- man/man4/zfs.4 | 4 ++-- man/man7/zfsprops.7 | 6 +++--- man/man8/zfs-hold.8 | 2 +- man/man8/zpool.8 | 2 +- 5 files changed, 10 insertions(+), 10 deletions(-) diff --git a/man/man4/spl.4 b/man/man4/spl.4 index de11d2b47..683f8e2b6 100644 --- a/man/man4/spl.4 +++ b/man/man4/spl.4 @@ -100,7 +100,7 @@ when exceeding this value. .It Sy spl_kmem_cache_magazine_size Ns = Ns Sy 0 Pq uint Cache magazines are an optimization designed to minimize the cost of allocating memory. -They do this by keeping a per-cpu cache of recently +They do this by keeping a per-CPU cache of recently freed objects, which can then be reallocated without taking a lock. This can improve performance on highly contended caches. However, because objects in magazines will prevent otherwise empty slabs @@ -111,8 +111,8 @@ For this reason, can be used to set a maximum magazine size. When this value is set to 0 the magazine size will be automatically determined based on the object size. -Otherwise magazines will be limited to 2-256 objects per magazine (i.e. per CPU). -Magazines may never be entirely disabled in this implementation. +Otherwise magazines will be limited to 2-256 objects per magazine (i.e. per +CPU). Magazines may never be entirely disabled in this implementation. . .It Sy spl_hostid Ns = Ns Sy 0 Pq ulong The system hostid, when set this can be used to uniquely identify a system. diff --git a/man/man4/zfs.4 b/man/man4/zfs.4 index 6d97a2363..fedb541f5 100644 --- a/man/man4/zfs.4 +++ b/man/man4/zfs.4 @@ -1307,7 +1307,7 @@ This should be less than .Sy zfs_vdev_async_write_active_min_dirty_percent . . .It Sy zfs_wrlog_data_max Ns = Pq int -The upper limit of write-transaction zil log data size in bytes. +The upper limit of write-transaction ZIL log data size in bytes. Write operations are throttled when approaching the limit until log data is cleared out after transaction group sync. Because of some overhead, it should be set at least 2 times the size of @@ -2408,7 +2408,7 @@ This controls the number of threads used by .Sy dp_zil_clean_taskq . The default value of .Sy 100% -will create a maximum of one thread per cpu. +will create a maximum of one thread per CPU. . .It Sy zil_maxblocksize Ns = Ns Sy 131072 Ns B Po 128 KiB Pc Pq uint This sets the maximum block size used by the ZIL. diff --git a/man/man7/zfsprops.7 b/man/man7/zfsprops.7 index 534d6c762..c9f94babb 100644 --- a/man/man7/zfsprops.7 +++ b/man/man7/zfsprops.7 @@ -263,10 +263,10 @@ this opaque token can be provided to to resume and complete the .Nm zfs Cm receive . .It Sy redact_snaps -For bookmarks, this is the list of snapshot guids the bookmark contains a +For bookmarks, this is the list of snapshot GUIDs the bookmark contains a redaction list for. -For snapshots, this is the list of snapshot guids the snapshot is redacted with +For snapshots, this is the list of snapshot GUIDs the snapshot is redacted with respect to. .It Sy referenced The amount of data that is accessible by this dataset, which may or may not be @@ -2098,7 +2098,7 @@ value behavior, see the "ZFS Administration Guide". .Sy formD Ns | Ns Sy formKC Ns | Ns Sy formKD .Xc Indicates whether the file system should perform a -.Sy unicode +.Sy Unicode normalization of file names whenever two file names are compared, and which normalization algorithm should be used. File names are always stored unmodified, names are normalized as part of any diff --git a/man/man8/zfs-hold.8 b/man/man8/zfs-hold.8 index 3895acab3..0c88937f0 100644 --- a/man/man8/zfs-hold.8 +++ b/man/man8/zfs-hold.8 @@ -88,7 +88,7 @@ listing the holds on the named snapshot. .It Fl H Do not print headers, use tab-delimited output. .It Fl p -Prints holds timestamps as unix epoch timestamps. +Prints holds timestamps as Unix epoch timestamps. .El .It Xo .Nm zfs diff --git a/man/man8/zpool.8 b/man/man8/zpool.8 index 115b55471..b96944050 100644 --- a/man/man8/zpool.8 +++ b/man/man8/zpool.8 @@ -535,7 +535,7 @@ The value is not used, only the presence or absence of the variable matters. .It Sy ZPOOL_VDEV_NAME_GUID Cause .Nm -subcommands to output vdev guids by default. +subcommands to output vdev GUIDs by default. This behavior is identical to the .Nm zpool Cm status Fl g command line option.