From: Zbigniew Jędrzejewski-Szmek Date: Wed, 28 May 2025 13:30:05 +0000 (+0200) Subject: man: reword descriptions of numerical fields X-Git-Tag: v258-rc1~460^2~3 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=de8d2894b8bd2d77c0f54d0fadd31a67fe1ba822;p=thirdparty%2Fsystemd.git man: reword descriptions of numerical fields A "string" is a concept in C. In a text-based API, this is implicit, especially if we say that something was "formatted". So change occurences of "decimal string" to just "decimal". Similarly, "numerics" is unclear, say "digits". Also, a "timestamp is in a clock" just sounds wrong. Reword those sentences. --- diff --git a/man/systemd.journal-fields.xml b/man/systemd.journal-fields.xml index b7a72af08b0..9f7f2c5cfa0 100644 --- a/man/systemd.journal-fields.xml +++ b/man/systemd.journal-fields.xml @@ -127,8 +127,8 @@ Note that the journal service does not validate the values of any structured journal fields whose name is not prefixed with an underscore, and this includes any syslog related fields such as these. Hence, applications that supply a facility, PID, - or log level are expected to do so properly formatted, i.e. as numeric integers formatted - as decimal strings. + or log level are expected to do so properly formatted, i.e. as integers formatted + as decimals. @@ -206,11 +206,10 @@ _UID= _GID= - The process, user, and group ID of the process the - journal entry originates from formatted as a decimal - string. Note that entries obtained via stdout or - stderr of forked processes will contain credentials valid for a parent - process (that initiated the connection to systemd-journald). + The process number, user number, and group number of the process the journal entry originates + from formatted as decimals. Note that entries obtained via stdout or + stderr of forked processes will contain credentials valid for a parent process + (that initiated the connection to systemd-journald). @@ -273,17 +272,17 @@ _SOURCE_REALTIME_TIMESTAMP= - The earliest trusted timestamp of the message, if any is known that is different from - the reception time of the journal. The timestamp is in the CLOCK_REALTIME - clock in microseconds, formatted as decimal strings. + The earliest trusted timestamp of the message, if any is known that is different from the + reception time of the journal. The timestamp is the CLOCK_REALTIME time in + microseconds, formatted as a decimal. _SOURCE_BOOTTIME_TIMESTAMP= - The earliest trusted timestamp of the message in CLOCK_BOOTTIME clock. - For details, refer to _SOURCE_REALTIME_TIMESTAMP=. + The earliest trusted timestamp of the message in the CLOCK_BOOTTIME + time, in the same format as _SOURCE_REALTIME_TIMESTAMP=. @@ -301,8 +300,7 @@ _MACHINE_ID= - The machine ID of the originating host, as available - in + The machine ID of the originating host, as described in machine-id5. @@ -322,7 +320,7 @@ _HOSTNAME= - The name of the originating host. + The hostname of the originating host. @@ -646,7 +644,7 @@ The wallclock time (CLOCK_REALTIME) at the point in time the entry was received by the journal, in microseconds since - the epoch UTC, formatted as a decimal string. This has + the epoch UTC, formatted as a decimal. This has different properties from _SOURCE_REALTIME_TIMESTAMP=, as it is usually a bit later but more likely to be monotonic. @@ -660,7 +658,7 @@ The monotonic time (CLOCK_MONOTONIC) at the point in time the entry was received by the journal in microseconds, - formatted as a decimal string. To be useful as an address + formatted as a decimal. To be useful as an address for the entry, this should be combined with the boot ID in _BOOT_ID=. diff --git a/man/systemd.net-naming-scheme.xml b/man/systemd.net-naming-scheme.xml index 96688ed3c91..24f2592b841 100644 --- a/man/systemd.net-naming-scheme.xml +++ b/man/systemd.net-naming-scheme.xml @@ -451,9 +451,10 @@ than 16381 (2¹⁴-1) were ignored. For s390 PCI devices index values up to 65535 (2¹⁶-1) are valid. To account for that, the limit was increased to 65535. - The udev rule NAME= replaces :, - /, and % with an underscore (_), and - refuses strings which contain only numerics. + The udev7 + rule NAME= replaces :, /, and + % with an underscore (_), and refuses strings which contain + only digits.