From 15bd45d1135444aa75feb9fc2cd157d2b5dc1118 Mon Sep 17 00:00:00 2001 From: Yu Watanabe Date: Wed, 16 Sep 2026 03:12:50 +0900 Subject: [PATCH] man: fix typos and grammar in various man pages --- man/capsule@.service.xml | 2 +- man/dnssec-trust-anchors.d.xml | 2 +- man/org.freedesktop.systemd1.xml | 18 +++++++++--------- man/org.freedesktop.sysupdate1.xml | 2 +- man/portablectl.xml | 2 +- man/repart.d.xml | 2 +- man/sd_bus_error.xml | 2 +- man/sd_bus_list_names.xml | 4 ++-- man/sd_bus_message_get_cookie.xml | 2 +- man/sd_bus_set_watch_bind.xml | 17 +++++++++-------- man/sd_device_enumerator_add_match_parent.xml | 2 +- man/sd_event_source_unref.xml | 10 +++++----- man/sd_journal_print.xml | 2 +- man/sd_journal_query_unique.xml | 4 ++-- man/sysctl.d.xml | 2 +- man/systemctl.xml | 11 +++++------ man/systemd-boot-random-seed.service.xml | 2 +- man/systemd-bsod.service.xml | 2 +- man/systemd-factory-reset.xml | 2 +- man/systemd-fsck@.service.xml | 4 ++-- man/systemd-getty-generator.xml | 2 +- man/systemd-journal-upload.service.xml | 8 ++++---- man/systemd-quotacheck@.service.xml | 4 ++-- man/systemd-random-seed.service.xml | 2 +- man/systemd-report-sign-tpm2@.service.xml | 2 +- man/systemd.netdev.xml | 5 +++-- man/sysusers.d.xml | 2 +- man/ukify.xml | 2 +- 28 files changed, 61 insertions(+), 60 deletions(-) diff --git a/man/capsule@.service.xml b/man/capsule@.service.xml index b9053e9f60..b58ddb57ac 100644 --- a/man/capsule@.service.xml +++ b/man/capsule@.service.xml @@ -77,7 +77,7 @@ for example with the switch. The capsule@.service unit invokes a systemd --user - service manager process. This means unit files are looked for according to the sames rules as for regular user + service manager process. This means unit files are looked for according to the same rules as for regular user service managers, for example in /var/lib/capsules/NAME/.config/systemd/user/. diff --git a/man/dnssec-trust-anchors.d.xml b/man/dnssec-trust-anchors.d.xml index 8a5523fd3f..053c704334 100644 --- a/man/dnssec-trust-anchors.d.xml +++ b/man/dnssec-trust-anchors.d.xml @@ -156,7 +156,7 @@ stag set of well-known private DNS zone domains is used as negative trust anchors. - It is also possibly to define per-interface negative trust + It is also possible to define per-interface negative trust anchors using the DNSSECNegativeTrustAnchors= setting in systemd.network5 diff --git a/man/org.freedesktop.systemd1.xml b/man/org.freedesktop.systemd1.xml index 929239c7d1..ab08aec354 100644 --- a/man/org.freedesktop.systemd1.xml +++ b/man/org.freedesktop.systemd1.xml @@ -33,7 +33,7 @@ for each unit and for each queued job. The unit objects implement a generic Unit interface as well as a type-specific interface. For example, service units implement both org.freedesktop.systemd1.Unit and - org.freedesktop.system1.Service. The manager object can list + org.freedesktop.systemd1.Service. The manager object can list unit and job objects or directly convert a unit name or job identifier to a bus path of the corresponding D-Bus object. @@ -1518,7 +1518,7 @@ node /org/freedesktop/systemd1 { Send a D-Bus message that will turn off status messages. Block until a reply to that message is received. - Print multiples lines without being interrupted by status messages. + Print multiple lines without being interrupted by status messages. Send a D-Bus message that will reset ShowStatus back to its original value. @@ -2086,7 +2086,7 @@ node /org/freedesktop/systemd1 { operations are allowed through the polkit privilege system. Operations which modify unit state (StartUnit(), StopUnit(), KillUnit(), KillUnitSubgroup(), QueueSignalUnit(), - RestartUnit() and similar, SetProperty()) require + RestartUnit() and similar, SetUnitProperties()) require org.freedesktop.systemd1.manage-units. Operations which modify unit file enablement state (EnableUnitFiles(), DisableUnitFiles(), EnableUnitFilesWithFlags(), DisableUnitFilesWithFlags(), @@ -5209,12 +5209,12 @@ node /org/freedesktop/systemd1/unit/avahi_2ddaemon_2eservice { for more details on how to retrieve these file descriptors. Unlike the ExtraFileDescriptors input property, ExtraFileDescriptorNames only contains names and not the file descriptors. - ManagedOOMMemoryPressureDurationUSec implement the destination parameter of the + ManagedOOMMemoryPressureDurationUSec implements the destination parameter of the unit file setting ManagedOOMMemoryPressureDurationSec= listed in systemd.resource-control5. Note the time unit is expressed in μs. - ProtectControlGroupsEx implement the destination parameter of the + ProtectControlGroupsEx implements the destination parameter of the unit file setting ProtectControlGroups= listed in systemd.exec5. Unlike boolean ProtectControlGroups, ProtectControlGroupsEx @@ -5225,7 +5225,7 @@ node /org/freedesktop/systemd1/unit/avahi_2ddaemon_2eservice { systemd.exec5. Note PrivatePIDs is a string type to allow adding more values in the future. - ProtectHostnameEx implement the destination parameter of the + ProtectHostnameEx implements the destination parameter of the unit file setting ProtectHostname= listed in systemd.exec5. Unlike boolean ProtectHostname, ProtectHostnameEx is a pair of @@ -12047,7 +12047,7 @@ node /org/freedesktop/systemd1/unit/system_2eslice { Most properties correspond directly with the matching settings in slice unit files. - ManagedOOMMemoryPressureDurationUSec implement the destination parameter of the + ManagedOOMMemoryPressureDurationUSec implements the destination parameter of the unit file setting ManagedOOMMemoryPressureDurationSec= listed in systemd.resource-control5. Note the time unit is expressed in μs. @@ -12726,10 +12726,10 @@ node /org/freedesktop/systemd1/unit/session_2d1_2escope { Controller contains the bus name (unique or well-known) that is notified when the scope unit is to be shut down via a RequestStop() signal (see below). This is - set when the scope is created. If not set, the scope's processes will terminated with + set when the scope is created. If not set, the scope's processes will be terminated with SIGTERM directly. - ManagedOOMMemoryPressureDurationUSec implement the destination parameter of the + ManagedOOMMemoryPressureDurationUSec implements the destination parameter of the unit file setting ManagedOOMMemoryPressureDurationSec= listed in systemd.resource-control5. Note the time unit is expressed in μs. diff --git a/man/org.freedesktop.sysupdate1.xml b/man/org.freedesktop.sysupdate1.xml index ab9720afa1..084106d2d8 100644 --- a/man/org.freedesktop.sysupdate1.xml +++ b/man/org.freedesktop.sysupdate1.xml @@ -96,7 +96,7 @@ node /org/freedesktop/sysupdate1 { The JobRemoved() signal is sent each time a job finishes, is canceled or fails. It also carries the job ID and object path, followed by a numeric status - code. If the status is zero, the job has succeed. A positive status should be treated as an + code. If the status is zero, the job has succeeded. A positive status should be treated as an exit code (i.e. EXIT_FAILURE), and a negative status should be treated as a negative errno-style error code (i.e. -EINVAL). diff --git a/man/portablectl.xml b/man/portablectl.xml index 76cae3a374..d7366376d9 100644 --- a/man/portablectl.xml +++ b/man/portablectl.xml @@ -122,7 +122,7 @@ By default, all unit files whose names start with a prefix generated from the image's file name are copied out. Specifically, the prefix is determined from the image file name with any suffix such as .raw removed, truncated at the first occurrence of an underscore character - (_), if there is one. The underscore logic is supposed to be used to versioning so that the + (_), if there is one. The underscore logic is supposed to be used for versioning so that an image file foobar_47.11.raw will result in a unit file matching prefix of foobar. This prefix is then compared with all unit files names contained in the image in the usual directories, but only unit file names where the prefix is followed by -, diff --git a/man/repart.d.xml b/man/repart.d.xml index 9b6b06f06c..3e012f8619 100644 --- a/man/repart.d.xml +++ b/man/repart.d.xml @@ -249,7 +249,7 @@ The textual label to assign to the partition if none is assigned yet. Note that this setting is not used for matching. It is also not used when a label is already set for an existing - partition. It is thus only used when a partition is newly created or when an existing one had a no + partition. It is thus only used when a partition is newly created or when an existing one had no label set (that is: an empty label). If not specified, a label derived from the partition type is automatically used. Simple specifier expansion is supported, see below. diff --git a/man/sd_bus_error.xml b/man/sd_bus_error.xml index eaae3b193b..793c8dac6e 100644 --- a/man/sd_bus_error.xml +++ b/man/sd_bus_error.xml @@ -238,7 +238,7 @@ due to lack of memory, in which case an SD_BUS_ERROR_NO_MEMORY error is set instead, and -ENOMEM is returned. - sd_bus_error_set_errnof() and sd_bus_error_set_errnof() + sd_bus_error_set_errnof() and sd_bus_error_set_errnofv() are similar to sd_bus_error_set_errno(), but in addition to error, take a printf3 format diff --git a/man/sd_bus_list_names.xml b/man/sd_bus_list_names.xml index 88010591a9..a370c6e770 100644 --- a/man/sd_bus_list_names.xml +++ b/man/sd_bus_list_names.xml @@ -44,8 +44,8 @@ org.freedesktop.DBus.ListNames to retrieve the list of currently-owned names on the bus. If acquired is not NULL, the function calls - org.freedesktop.DBus.ListActivableNames to retrieve the list of all names on the bus that can be - activated. Note that ownership of the arrays returned by sd_bus_list_names() in + org.freedesktop.DBus.ListActivatableNames to retrieve the list of all names on the bus that can + be activated. Note that ownership of the arrays returned by sd_bus_list_names() in acquired and activatable is transferred to the caller and hence, the caller is responsible for freeing these arrays and their contents. diff --git a/man/sd_bus_message_get_cookie.xml b/man/sd_bus_message_get_cookie.xml index 4a5d4168fd..7a4004cc47 100644 --- a/man/sd_bus_message_get_cookie.xml +++ b/man/sd_bus_message_get_cookie.xml @@ -19,7 +19,7 @@ sd_bus_message_get_cookie sd_bus_message_get_reply_cookie - Returns the transaction cookie of a message + Return the transaction cookie of a message diff --git a/man/sd_bus_set_watch_bind.xml b/man/sd_bus_set_watch_bind.xml index 8a51427862..2f2612a39a 100644 --- a/man/sd_bus_set_watch_bind.xml +++ b/man/sd_bus_set_watch_bind.xml @@ -44,14 +44,15 @@ Description - sd_bus_set_watch_bind() may be used to enable or disable client-side watching of server - socket binding for a bus connection object. If the b is true, the feature is enabled, - otherwise disabled (which is the default). When enabled, and the selected bus address refers to an - AF_UNIX socket in the file system which does not exist while the connection attempt is made an - inotify7 watch is installed on - it, waiting for the socket to appear. As soon as the socket appears the connection is made. This functionality is - useful in particular in early-boot programs that need to run before the system bus is available, but want to - connect to it the instant it may be connected to. + sd_bus_set_watch_bind() may be used to enable or disable client-side watching + of server socket binding for a bus connection object. If b is true, the feature is + enabled, otherwise disabled (which is the default). When enabled, and the selected bus address refers to + an AF_UNIX socket in the file system which does not exist while the connection + attempt is made, an + inotify7 + watch is installed on it, waiting for the socket to appear. As soon as the socket appears the connection + is made. This functionality is useful in particular in early-boot programs that need to run before the + system bus is available, but want to connect to it the instant it may be connected to. sd_bus_get_watch_bind() may be used to query the current setting of this feature. It returns zero when the feature is disabled, and positive if enabled. diff --git a/man/sd_device_enumerator_add_match_parent.xml b/man/sd_device_enumerator_add_match_parent.xml index 15ec6b5e9c..41a1b97c95 100644 --- a/man/sd_device_enumerator_add_match_parent.xml +++ b/man/sd_device_enumerator_add_match_parent.xml @@ -144,7 +144,7 @@ The sd_device_enumerator_add_nomatch_sysname() function adds a filter so that devices whose sysname equals to sysname are excluded from the enumeration. This is useful for excluding specific devices from the enumeration process. - When called multiple times, features are ANDed. + When called multiple times, filters are ANDed. The sd_device_enumerator_add_match_tag() function adds a filter so that only devices tagged with tag are enumerated. When called multiple times, diff --git a/man/sd_event_source_unref.xml b/man/sd_event_source_unref.xml index 3494179285..ae9d4a97ce 100644 --- a/man/sd_event_source_unref.xml +++ b/man/sd_event_source_unref.xml @@ -78,11 +78,11 @@ sd_event_source_ref() may be used to increase by one the internal reference counter of the event source object specified as source. - sd_event_source_unref(), - sd_bus_creds_unrefp() and - sd_bus_creds_ref() execute no operation if - the passed event source object is - NULL. + sd_event_source_ref() and + sd_event_source_unref() execute no operation if the passed event source + object is NULL. sd_event_source_unrefp() will first + dereference its argument, which must not be NULL, and will execute no + operation if that is NULL. Note that event source objects stay alive and may be dispatched as long as they have a reference counter greater than zero. In order to drop a reference of an event source and make sure the associated diff --git a/man/sd_journal_print.xml b/man/sd_journal_print.xml index ea766b2a28..e522127ede 100644 --- a/man/sd_journal_print.xml +++ b/man/sd_journal_print.xml @@ -163,7 +163,7 @@ sd_journal_print() and sd_journal_send() described above, which are based on format strings, and do strip trailing whitespace. - sd_journal_perror() is a similar to + sd_journal_perror() is similar to perror3 and writes a message to the journal that consists of the passed string, suffixed with ": " and a human-readable representation of diff --git a/man/sd_journal_query_unique.xml b/man/sd_journal_query_unique.xml index 3ad1146059..50ced0222c 100644 --- a/man/sd_journal_query_unique.xml +++ b/man/sd_journal_query_unique.xml @@ -117,8 +117,8 @@ sd_journal_query_unique() returns 0 on success or a negative errno-style error code. sd_journal_enumerate_unique() and - sd_journal_query_available_unique() return a positive integer if the next field data - has been read, 0 when no more fields remain, or a negative errno-style error code. + sd_journal_enumerate_available_unique() return a positive integer if the next field + data has been read, 0 when no more fields remain, or a negative errno-style error code. sd_journal_restart_unique() does not return anything. diff --git a/man/sysctl.d.xml b/man/sysctl.d.xml index 9bcd62aa53..a73b6bc20e 100644 --- a/man/sysctl.d.xml +++ b/man/sysctl.d.xml @@ -155,7 +155,7 @@ net.bridge.bridge-nf-call-arptables = 0 This method forces the module to be always loaded. Please note that, unless the br_netfilter module is - loaded, bridged packets will not be filtered with Netfilter + loaded, bridged packets will not be filtered by Netfilter (starting with kernel 3.18), so simply not loading the module is sufficient to avoid filtering. diff --git a/man/systemctl.xml b/man/systemctl.xml index bfd6858665..6dc8d33642 100644 --- a/man/systemctl.xml +++ b/man/systemctl.xml @@ -740,8 +740,8 @@ Jan 12 10:46:45 example.com bluetoothd[8900]: gatt-time-server: Input/output err (e.g.: with , , etc.). This command supports bind-mounting directories, regular files, device nodes, AF_UNIX socket nodes, as well as FIFOs. The bind mount is ephemeral, and it is undone as soon as the - current unit process exists. Note that the namespace mentioned here, where the bind mount will be - added to, is the one where the main service process runs. Other processes (those exececuted by + current unit process exits. Note that the namespace mentioned here, where the bind mount will be + added to, is the one where the main service process runs. Other processes (those executed by , , etc.) run in distinct namespaces. @@ -767,15 +767,14 @@ Jan 12 10:46:45 example.com bluetoothd[8900]: gatt-time-server: Input/output err /). The following argument, if any, is interpreted as a colon-separated tuple of partition name and comma-separated list of mount options for that partition. The format is the same as the service - setting. When combined with the switch, a ready-only mount is + setting. When combined with the switch, a read-only mount is created. When combined with the switch, the destination path is first created before the mount is applied. Note that this option is currently only supported for units that run within a mount namespace (i.e. with , , etc.). Note that the - namespace mentioned here where the image mount will be added to, is the one where the main service - process runs. Note that the namespace mentioned here, where the bind mount will be - added to, is the one where the main service process runs. Other processes (those exececuted by + namespace mentioned here, where the image mount will be added to, is the one where the main + service process runs. Other processes (those executed by , , etc.) run in distinct namespaces. diff --git a/man/systemd-boot-random-seed.service.xml b/man/systemd-boot-random-seed.service.xml index 0993f7a75e..02e8d1e70c 100644 --- a/man/systemd-boot-random-seed.service.xml +++ b/man/systemd-boot-random-seed.service.xml @@ -82,7 +82,7 @@ the boot loader random seed with a new value derived from the kernel entropy pool. - This logic should ensure that the kernel's entropy pool is seeded during earliest bool already, if + This logic should ensure that the kernel's entropy pool is seeded during earliest boot already, if possible, but the highest quality entropy is propagated back to both on-disk seeds. diff --git a/man/systemd-bsod.service.xml b/man/systemd-bsod.service.xml index ad16b69eaa..dd4f346f55 100644 --- a/man/systemd-bsod.service.xml +++ b/man/systemd-bsod.service.xml @@ -19,7 +19,7 @@ systemd-bsod.service systemd-bsod - Displays boot-time emergency log message in full screen + Display boot-time emergency log message in full screen diff --git a/man/systemd-factory-reset.xml b/man/systemd-factory-reset.xml index ade78445c6..73ae49de7a 100644 --- a/man/systemd-factory-reset.xml +++ b/man/systemd-factory-reset.xml @@ -37,7 +37,7 @@ Description systemd-factory-reset is a tool that can query the current factory reset - state, request factory request operations or complete them. + state, request factory reset operations or complete them. Some of the functionality is also available via the /run/systemd/io.systemd.FactoryReset Varlink service (implemented via the diff --git a/man/systemd-fsck@.service.xml b/man/systemd-fsck@.service.xml index e6d34538fe..cb5c4002dd 100644 --- a/man/systemd-fsck@.service.xml +++ b/man/systemd-fsck@.service.xml @@ -124,8 +124,8 @@ fsck.repair - The contents of the credentials are parsed as same as the kernel command line options with - the same name. See above for more details. + The contents of the credentials are parsed in the same way as the kernel command line options + of the same name. See above for more details. diff --git a/man/systemd-getty-generator.xml b/man/systemd-getty-generator.xml index d02069e630..db94fe8680 100644 --- a/man/systemd-getty-generator.xml +++ b/man/systemd-getty-generator.xml @@ -82,7 +82,7 @@ active kernel consoles will be enabled. This option will be ignored when the system is running in a container. - When builtins is specified, serial-getty@.service for + When builtin is specified, serial-getty@.service for available virtualizer consoles will be enabled. This option will be ignored when the system is running in a container. diff --git a/man/systemd-journal-upload.service.xml b/man/systemd-journal-upload.service.xml index 5bc843cd74..4474b6f599 100644 --- a/man/systemd-journal-upload.service.xml +++ b/man/systemd-journal-upload.service.xml @@ -45,10 +45,10 @@ Unless limited by one of the options specified below, all journal entries accessible to the user the program is running as will be uploaded, and then the program will wait and send new entries as they become available. - - systemd-journal-upload transfers the raw content of journal file and - uses HTTP as a transport protocol. - + + systemd-journal-upload transfers the raw content of journal files and + uses HTTP as a transport protocol. + systemd-journal-upload.service is a system service that uses systemd-journal-upload to upload journal entries to a server. It uses the configuration in diff --git a/man/systemd-quotacheck@.service.xml b/man/systemd-quotacheck@.service.xml index 56397ff7bd..82665be34b 100644 --- a/man/systemd-quotacheck@.service.xml +++ b/man/systemd-quotacheck@.service.xml @@ -75,8 +75,8 @@ quotacheck.mode - The contents of the credential is parsed as same as the kernel command line option with the - same name. See above for more details. + The contents of the credential are parsed in the same way as the kernel command line option + of the same name. See above for more details. diff --git a/man/systemd-random-seed.service.xml b/man/systemd-random-seed.service.xml index eaf092860c..8dddea6d9d 100644 --- a/man/systemd-random-seed.service.xml +++ b/man/systemd-random-seed.service.xml @@ -75,7 +75,7 @@ entropy when loading the random seed. With this option this behaviour may be changed: it either takes a boolean parameter or the special string force. Defaults to false, in which case no entropy is credited. If true, entropy is credited if the random seed file and system state pass - various superficial concisistency checks. If set to force entropy is credited, + various superficial consistency checks. If set to force entropy is credited, regardless of these checks, as long as the random seed file exists. diff --git a/man/systemd-report-sign-tpm2@.service.xml b/man/systemd-report-sign-tpm2@.service.xml index f4917dd945..4ba9309474 100644 --- a/man/systemd-report-sign-tpm2@.service.xml +++ b/man/systemd-report-sign-tpm2@.service.xml @@ -63,7 +63,7 @@ The report additionally includes the measurement event log, and the public area of the signing key. The public area is provided as a JSON encoded TPMT_PUBLIC structure, and in PEM - encooded form. + encoded form. The preceding components are all executed under the audit session, and the report is only generated if that session remains exclusive throughout. Because the audit session attestation records whether the diff --git a/man/systemd.netdev.xml b/man/systemd.netdev.xml index 934c02328f..923ab57586 100644 --- a/man/systemd.netdev.xml +++ b/man/systemd.netdev.xml @@ -1268,9 +1268,10 @@ Ports=eth2 Layer2SpecificHeader= - Specifies layer2specific header type of the session. One of none or default. Defaults to default. + Specifies the layer 2 specific header type of the session. One of none or + default. Defaults to default. - + diff --git a/man/sysusers.d.xml b/man/sysusers.d.xml index e6a0ae34d7..cac0b0c385 100644 --- a/man/sysusers.d.xml +++ b/man/sysusers.d.xml @@ -251,7 +251,7 @@ r - 500-900 Only applies to lines of type u and should otherwise be left unset (or -). It is recommended to omit this, unless - a shell different /usr/sbin/nologin must be used. + a shell different from /usr/sbin/nologin must be used. diff --git a/man/ukify.xml b/man/ukify.xml index cf30ac937f..9dfe416d57 100644 --- a/man/ukify.xml +++ b/man/ukify.xml @@ -53,7 +53,7 @@ a boot loader. When used with qemu, a UKI can also be executed through "direct kernel boot", see example below. - ukify can also be used generate other types of UKI-like images, in particular + ukify can also be used to generate other types of UKI-like images, in particular extensions. See the description of the build verb below. ukify can also generate certificates and keys for SecureBoot and PCR signing, see the description of the genkey verb below. ukify can also print detailed information about