diff --git a/man/busctl.xml b/man/busctl.xml index b6471388bd..612e9733fe 100644 --- a/man/busctl.xml +++ b/man/busctl.xml @@ -44,7 +44,7 @@ - list + list Show all peers on the bus, by their service names. By default, shows both unique and well-known names, but @@ -56,7 +56,7 @@ - status SERVICE + status SERVICE Show process information and credentials of a bus service (if one is specified by its unique or well-known @@ -68,7 +68,7 @@ - monitor SERVICE + monitor SERVICE Dump messages being exchanged. If SERVICE is specified, show messages @@ -81,7 +81,7 @@ - capture SERVICE + capture SERVICE Similar to monitor but writes the output in pcapng format (for details, see @@ -96,7 +96,7 @@ - tree SERVICE + tree SERVICE Shows an object tree of one or more services. If SERVICE is specified, @@ -108,7 +108,7 @@ - introspect SERVICE OBJECT INTERFACE + introspect SERVICE OBJECT INTERFACE Show interfaces, methods, properties and signals of the specified object (identified by its path) on @@ -120,7 +120,7 @@ - call SERVICE OBJECT INTERFACE METHOD SIGNATURE ARGUMENT + call SERVICE OBJECT INTERFACE METHOD SIGNATURE ARGUMENT Invoke a method and show the response. Takes a service name, object path, interface name and method name. If @@ -134,7 +134,7 @@ - emit OBJECT INTERFACE SIGNAL SIGNATURE ARGUMENT + emit OBJECT INTERFACE SIGNAL SIGNATURE ARGUMENT Emit a signal. Takes an object path, interface name and method name. If parameters shall be passed, a signature string is required, followed by the arguments, individually formatted as @@ -145,7 +145,7 @@ - get-property SERVICE OBJECT INTERFACE PROPERTY + get-property SERVICE OBJECT INTERFACE PROPERTY Retrieve the current value of one or more object properties. Takes a service name, object path, @@ -159,7 +159,7 @@ - set-property SERVICE OBJECT INTERFACE PROPERTY SIGNATURE ARGUMENT + set-property SERVICE OBJECT INTERFACE PROPERTY SIGNATURE ARGUMENT Set the current value of an object property. Takes a service name, object path, interface name, @@ -170,7 +170,7 @@ - help + help Show command syntax help. diff --git a/man/cgroup-sandboxing.xml b/man/cgroup-sandboxing.xml index 56f7c4007b..c9e068f887 100644 --- a/man/cgroup-sandboxing.xml +++ b/man/cgroup-sandboxing.xml @@ -1,16 +1,17 @@ - + + -<para id="singular">This option cannot be bypassed by prefixing <literal>+</literal> to the executable path -in the service unit, as it applies to the whole control group.</para> + <para id="singular">This option cannot be bypassed by prefixing <literal>+</literal> to the executable path + in the service unit, as it applies to the whole control group.</para> -<para id="plural">These options cannot be bypassed by prefixing <literal>+</literal> to the executable path -in the service unit, as it applies to the whole control group.</para> + <para id="plural">These options cannot be bypassed by prefixing <literal>+</literal> to the executable path + in the service unit, as it applies to the whole control group.</para> </refsect1> diff --git a/man/common-variables.xml b/man/common-variables.xml index 81425e57e2..35ac98048f 100644 --- a/man/common-variables.xml +++ b/man/common-variables.xml @@ -1,5 +1,5 @@ <?xml version="1.0"?> -<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" +<!DOCTYPE refsection PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> <!-- SPDX-License-Identifier: LGPL-2.1-or-later --> @@ -116,24 +116,28 @@ <varlistentry> <term><option>K</option></term> - <para>This option instructs the pager to exit immediately when - <keycombo><keycap>Ctrl</keycap><keycap>C</keycap></keycombo> is pressed. To allow - <command>less</command> to handle <keycombo><keycap>Ctrl</keycap><keycap>C</keycap></keycombo> - itself to switch back to the pager command prompt, unset this option.</para> + <listitem> + <para>This option instructs the pager to exit immediately when + <keycombo><keycap>Ctrl</keycap><keycap>C</keycap></keycombo> is pressed. To allow + <command>less</command> to handle <keycombo><keycap>Ctrl</keycap><keycap>C</keycap></keycombo> + itself to switch back to the pager command prompt, unset this option.</para> - <para>If the value of <varname>$SYSTEMD_LESS</varname> does not include <literal>K</literal>, - and the pager that is invoked is <command>less</command>, - <keycombo><keycap>Ctrl</keycap><keycap>C</keycap></keycombo> will be ignored by the - executable, and needs to be handled by the pager.</para> + <para>If the value of <varname>$SYSTEMD_LESS</varname> does not include <literal>K</literal>, + and the pager that is invoked is <command>less</command>, + <keycombo><keycap>Ctrl</keycap><keycap>C</keycap></keycombo> will be ignored by the + executable, and needs to be handled by the pager.</para> + </listitem> </varlistentry> <varlistentry> <term><option>X</option></term> - <para>This option instructs the pager to not send termcap initialization and deinitialization - strings to the terminal. It is set by default to allow command output to remain visible in the - terminal even after the pager exits. Nevertheless, this prevents some pager functionality from - working, in particular paged output cannot be scrolled with the mouse.</para> + <listitem> + <para>This option instructs the pager to not send termcap initialization and deinitialization + strings to the terminal. It is set by default to allow command output to remain visible in the + terminal even after the pager exits. Nevertheless, this prevents some pager functionality from + working, in particular paged output cannot be scrolled with the mouse.</para> + </listitem> </varlistentry> </variablelist> diff --git a/man/journald.conf.xml b/man/journald.conf.xml index 126f967559..01072083c2 100644 --- a/man/journald.conf.xml +++ b/man/journald.conf.xml @@ -387,7 +387,7 @@ <para>When forwarding to the kernel log buffer (kmsg), make sure to select a suitably large size for the log buffer, for example by adding <literal>log_buf_len=8M</literal> to the kernel command line. <command>systemd</command> will automatically disable kernel's rate-limiting applied to userspace - processes (equivalent to setting <literal>printk.devkmsg=on</literal>).</para></listitem> + processes (equivalent to setting <literal>printk.devkmsg=on</literal>).</para> <para>Note: Forwarding is performed synchronously within journald, and may significantly affect its performance. This is particularly relevant when using ForwardToConsole=yes in cloud environments, @@ -397,6 +397,7 @@ journal also becoming blocked. Unless actively debugging/developing something, it's generally preferable to setup a <command>journalctl --follow</command> style service redirected to the console, instead of ForwardToConsole=yes, for production use.</para> + </listitem> </varlistentry> <varlistentry> diff --git a/man/libsystemd-pkgconfig.xml b/man/libsystemd-pkgconfig.xml index 3d22870739..02e4b8fc72 100644 --- a/man/libsystemd-pkgconfig.xml +++ b/man/libsystemd-pkgconfig.xml @@ -1,5 +1,5 @@ <?xml version="1.0"?> -<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" +<!DOCTYPE refsect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> <!-- SPDX-License-Identifier: LGPL-2.1-or-later --> diff --git a/man/networkctl.xml b/man/networkctl.xml index fbf5a0633e..0ca29d5440 100644 --- a/man/networkctl.xml +++ b/man/networkctl.xml @@ -576,6 +576,7 @@ s - Service VLAN, m - Two-port MAC Relay (TPMR) <xi:include href="version-info.xml" xpointer="v254"/> </listitem> + </varlistentry> <varlistentry> <term><option>--runtime</option></term> @@ -587,7 +588,6 @@ s - Service VLAN, m - Two-port MAC Relay (TPMR) <xi:include href="version-info.xml" xpointer="v256"/> </listitem> </varlistentry> - </varlistentry> <xi:include href="standard-options.xml" xpointer="json" /> <xi:include href="standard-options.xml" xpointer="help" /> diff --git a/man/portablectl.xml b/man/portablectl.xml index 2044428913..6352a8259b 100644 --- a/man/portablectl.xml +++ b/man/portablectl.xml @@ -155,11 +155,11 @@ files. This is a convenience feature to allow all arguments passed as <command>attach</command> also to <command>detach</command>.</para> - <xi:include href="version-info.xml" xpointer="v239"/></listitem> - <para>If <option>--now</option> and/or <option>--enable</option> are passed, the portable services are immediately stopped (blocking operation) and/or disabled before detaching the image. Prefix(es) are also accepted, to be used in case the unit names do not match the image name as described in the <command>attach</command>.</para> + + <xi:include href="version-info.xml" xpointer="v239"/></listitem> </varlistentry> <varlistentry> @@ -171,11 +171,11 @@ character has to match. If the new image doesn't exist, the existing one will not be detached. The parameters follow the same syntax as the <command>attach</command> command.</para> - <xi:include href="version-info.xml" xpointer="v248"/></listitem> - <para>If <option>--now</option> and/or <option>--enable</option> are passed, the portable services are immediately stopped if removed, started and/or enabled if added, or restarted if updated. Prefixes are also accepted, in the same way as described in the <command>attach</command> case.</para> + + <xi:include href="version-info.xml" xpointer="v248"/></listitem> </varlistentry> <varlistentry> diff --git a/man/poweroff.xml b/man/poweroff.xml index f3385357ee..cb3b4561af 100644 --- a/man/poweroff.xml +++ b/man/poweroff.xml @@ -55,9 +55,11 @@ <varlistentry> <term><option>--help</option></term> - <xi:include href="standard-options.xml" xpointer="help-text" /> + <listitem> + <xi:include href="standard-options.xml" xpointer="help-para" /> - <xi:include href="version-info.xml" xpointer="v253"/> + <xi:include href="version-info.xml" xpointer="v253"/> + </listitem> </varlistentry> <varlistentry> diff --git a/man/sd-id128.xml b/man/sd-id128.xml index 9febbe5f51..4ef3d393be 100644 --- a/man/sd-id128.xml +++ b/man/sd-id128.xml @@ -102,7 +102,7 @@ <funcdef>int <function>sd_id128_in_set_sentinel</function></funcdef> <paramdef>sd_id128_t <parameter>id</parameter></paramdef> <paramdef>…</paramdef> - <paramdef><constant>SD_ID128_NULL</constant></paramdef> + <paramdef><parameter><constant>SD_ID128_NULL</constant></parameter></paramdef> </funcprototype> <funcprototype> diff --git a/man/sd_bus_call.xml b/man/sd_bus_call.xml index 6cae300234..e9d5345ed3 100644 --- a/man/sd_bus_call.xml +++ b/man/sd_bus_call.xml @@ -122,22 +122,24 @@ <varlistentry> <term><constant>-EINVAL</constant></term> - <listitem><para>The input parameter <parameter>m</parameter> is <constant>NULL</constant>. - </para> + <listitem> + <para>The input parameter <parameter>m</parameter> is <constant>NULL</constant>. + </para> - <xi:include href="version-info.xml" xpointer="v246"/></listitem> + <para>The input parameter <parameter>m</parameter> is not a D-Bus method call. + To create a new D-Bus method call, use + <citerefentry><refentrytitle>sd_bus_message_new_method_call</refentrytitle><manvolnum>3</manvolnum></citerefentry>. + </para> - <listitem><para>The input parameter <parameter>m</parameter> is not a D-Bus method call. - To create a new D-Bus method call, use - <citerefentry><refentrytitle>sd_bus_message_new_method_call</refentrytitle><manvolnum>3</manvolnum></citerefentry>. - </para></listitem> + <para>The input parameter <parameter>m</parameter> has the + <constant>BUS_MESSAGE_NO_REPLY_EXPECTED</constant> flag set.</para> - <listitem><para>The input parameter <parameter>m</parameter> has the - <constant>BUS_MESSAGE_NO_REPLY_EXPECTED</constant> flag set.</para></listitem> + <para>The input parameter <parameter>error</parameter> is + non-<constant>NULL</constant> but was not set to <constant>SD_BUS_ERROR_NULL</constant>. + </para> - <listitem><para>The input parameter <parameter>error</parameter> is - non-<constant>NULL</constant> but was not set to <constant>SD_BUS_ERROR_NULL</constant>. - </para></listitem> + <xi:include href="version-info.xml" xpointer="v246"/> + </listitem> </varlistentry> <varlistentry> diff --git a/man/standard-conf.xml b/man/standard-conf.xml index cc2b874016..0174c090e9 100644 --- a/man/standard-conf.xml +++ b/man/standard-conf.xml @@ -8,6 +8,8 @@ --> <refsection> + <title/> + <refsection id='confd'> <title>Configuration Directories and Precedence diff --git a/man/standard-options.xml b/man/standard-options.xml index eb27f5cb65..aec9a0d750 100644 --- a/man/standard-options.xml +++ b/man/standard-options.xml @@ -1,5 +1,5 @@ - @@ -11,7 +11,7 @@ - Print a short help text and exit. + Print a short help text and exit. diff --git a/man/standard-specifiers.xml b/man/standard-specifiers.xml index 7aa7acaf60..3a2c0b0266 100644 --- a/man/standard-specifiers.xml +++ b/man/standard-specifiers.xml @@ -1,5 +1,5 @@ - diff --git a/man/supported-controllers.xml b/man/supported-controllers.xml index 61cdf468d9..3ec06939e6 100644 --- a/man/supported-controllers.xml +++ b/man/supported-controllers.xml @@ -1,14 +1,15 @@ - + + -<para id="controllers-text">The following controller names may be specified: <option>cpu</option>, <option>cpuacct</option>, -<option>cpuset</option>, <option>io</option>, <option>blkio</option>, <option>memory</option>, <option>devices</option>, -<option>pids</option>, <option>bpf-firewall</option>, and <option>bpf-devices</option>.</para> + <para id="controllers-text">The following controller names may be specified: <option>cpu</option>, <option>cpuacct</option>, + <option>cpuset</option>, <option>io</option>, <option>blkio</option>, <option>memory</option>, <option>devices</option>, + <option>pids</option>, <option>bpf-firewall</option>, and <option>bpf-devices</option>.</para> </refsect1> diff --git a/man/system-only.xml b/man/system-only.xml index afd3d32bc5..39786e8384 100644 --- a/man/system-only.xml +++ b/man/system-only.xml @@ -1,5 +1,5 @@ <?xml version="1.0"?> -<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> +<!DOCTYPE refsect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> <!-- SPDX-License-Identifier: LGPL-2.1-or-later diff --git a/man/system-or-user-ns.xml b/man/system-or-user-ns.xml index 532c1ef64e..1475ed06e2 100644 --- a/man/system-or-user-ns.xml +++ b/man/system-or-user-ns.xml @@ -1,5 +1,5 @@ <?xml version="1.0"?> -<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> +<!DOCTYPE refsect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> <!-- SPDX-License-Identifier: LGPL-2.1-or-later diff --git a/man/systemd-ask-password.xml b/man/systemd-ask-password.xml index 91909ff33f..9eccf8fffc 100644 --- a/man/systemd-ask-password.xml +++ b/man/systemd-ask-password.xml @@ -23,7 +23,7 @@ <refsynopsisdiv> <cmdsynopsis> - <command>systemd-ask-password <arg choice="opt" rep="repeat">OPTIONS</arg> <arg choice="opt">MESSAGE</arg></command> + <command>systemd-ask-password</command> <arg choice="opt" rep="repeat">OPTIONS</arg> <arg choice="opt">MESSAGE</arg> </cmdsynopsis> </refsynopsisdiv> diff --git a/man/systemd.generator.xml b/man/systemd.generator.xml index d8dbdce87a..16aa54937a 100644 --- a/man/systemd.generator.xml +++ b/man/systemd.generator.xml @@ -26,8 +26,8 @@ <cmdsynopsis> <command index='false'>/path/to/generator</command> <arg choice="plain"><replaceable>normal-dir</replaceable></arg> - <arg choice="option"><replaceable>early-dir</replaceable></arg> - <arg choice="option"><replaceable>late-dir</replaceable></arg> + <arg choice="opt"><replaceable>early-dir</replaceable></arg> + <arg choice="opt"><replaceable>late-dir</replaceable></arg> </cmdsynopsis> <para><simplelist> diff --git a/man/systemd.net-naming-scheme.xml b/man/systemd.net-naming-scheme.xml index db17211f58..07ab26e6f6 100644 --- a/man/systemd.net-naming-scheme.xml +++ b/man/systemd.net-naming-scheme.xml @@ -223,7 +223,7 @@ </table> <para>The PCI domain is only prepended when it is not 0. All multi-function PCI devices will carry - the <constant>f<replaceable>function</replaceable></constant> number in the device name, including + the <constant>f</constant><replaceable>function</replaceable> number in the device name, including the function 0 device. For non-multi-function devices, the number is suppressed if 0. The port name <replaceable>port_name</replaceable> is used, or the port number <constant>d</constant><replaceable>dev_port</replaceable> if the name is not known.</para> diff --git a/man/systemd.syntax.xml b/man/systemd.syntax.xml index 2fc22885ca..a0d63f994d 100644 --- a/man/systemd.syntax.xml +++ b/man/systemd.syntax.xml @@ -89,7 +89,7 @@ file type. When a comment line or lines follow a line ending with a backslash, the comment block is ignored, so the continued line is concatenated with whatever follows the comment block.</para> - <example><programlisting>[Section A] + <informalexample><programlisting>[Section A] KeyOne=value 1 KeyTwo=value 2 @@ -105,7 +105,7 @@ KeyThree=value 3\ # this line is ignored ; this line is ignored too value 3 continued -</programlisting></example> +</programlisting></informalexample> <para>Boolean arguments used in configuration files can be written in various formats. For positive settings the strings diff --git a/man/tc.xml b/man/tc.xml index 8d39be3d19..f845b15881 100644 --- a/man/tc.xml +++ b/man/tc.xml @@ -1,11 +1,13 @@ <?xml version="1.0"?> -<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> +<!DOCTYPE refsect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> <!-- SPDX-License-Identifier: LGPL-2.1-or-later --> <refsect1> + <title/> + <variablelist class='network-directives'> <varlistentry id='qdisc-parent'> <term><varname>Parent=</varname></term> diff --git a/man/telinit.xml b/man/telinit.xml index 6b59373a60..875f0746e1 100644 --- a/man/telinit.xml +++ b/man/telinit.xml @@ -23,7 +23,7 @@ <refsynopsisdiv> <cmdsynopsis> - <command>telinit <arg choice="opt" rep="repeat">OPTIONS</arg> <arg choice="req">COMMAND</arg></command> + <command>telinit</command> <arg choice="opt" rep="repeat">OPTIONS</arg> <arg choice="req">COMMAND</arg> </cmdsynopsis> </refsynopsisdiv> diff --git a/man/threads-aware.xml b/man/threads-aware.xml index 442e45bbbb..bb39266626 100644 --- a/man/threads-aware.xml +++ b/man/threads-aware.xml @@ -1,23 +1,24 @@ <?xml version="1.0"?> -<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" +<!DOCTYPE refsect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> <!-- SPDX-License-Identifier: LGPL-2.1-or-later --> <refsect1> + <title/> -<para id="strict">All functions listed here are thread-agnostic and only a single specific thread may operate on a -given object during its entire lifetime. It's safe to allocate multiple independent objects and use each from a -specific thread in parallel. However, it's not safe to allocate such an object in one thread, and operate or free it -from any other, even if locking is used to ensure these threads don't operate on it at the very same time.</para> + <para id="strict">All functions listed here are thread-agnostic and only a single specific thread may operate on a + given object during its entire lifetime. It's safe to allocate multiple independent objects and use each from a + specific thread in parallel. However, it's not safe to allocate such an object in one thread, and operate or free it + from any other, even if locking is used to ensure these threads don't operate on it at the very same time.</para> -<para id="safe">All functions listed here are thread-safe and may be called in parallel from multiple threads.</para> + <para id="safe">All functions listed here are thread-safe and may be called in parallel from multiple threads.</para> -<para id='getenv'>The code described here uses -<citerefentry project='man-pages'><refentrytitle>getenv</refentrytitle><manvolnum>3</manvolnum></citerefentry>, -which is declared to be not multi-thread-safe. This means that the code calling the functions described -here must not call -<citerefentry project='man-pages'><refentrytitle>setenv</refentrytitle><manvolnum>3</manvolnum></citerefentry> -from a parallel thread. It is recommended to only do calls to <function>setenv()</function> -from an early phase of the program when no other threads have been started.</para> + <para id='getenv'>The code described here uses + <citerefentry project='man-pages'><refentrytitle>getenv</refentrytitle><manvolnum>3</manvolnum></citerefentry>, + which is declared to be not multi-thread-safe. This means that the code calling the functions described + here must not call + <citerefentry project='man-pages'><refentrytitle>setenv</refentrytitle><manvolnum>3</manvolnum></citerefentry> + from a parallel thread. It is recommended to only do calls to <function>setenv()</function> + from an early phase of the program when no other threads have been started.</para> </refsect1> diff --git a/man/user-system-options.xml b/man/user-system-options.xml index f3bafaea38..952ac18a4f 100644 --- a/man/user-system-options.xml +++ b/man/user-system-options.xml @@ -1,5 +1,5 @@ <?xml version="1.0"?> -<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" +<!DOCTYPE variablelist PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> <!-- SPDX-License-Identifier: LGPL-2.1-or-later --> diff --git a/man/veritytab.xml b/man/veritytab.xml index 43e8c56f29..e58edf1a50 100644 --- a/man/veritytab.xml +++ b/man/veritytab.xml @@ -129,7 +129,6 @@ This is based on crypttab(5). provided in standard UUID format, e.g. 12345678-1234-1234-1234-123456789abc.</para> <xi:include href="version-info.xml" xpointer="v254"/></listitem> - <listitem><para></para></listitem> </varlistentry> <varlistentry> diff --git a/man/version-info.xml b/man/version-info.xml index 5dabf9d31a..414172873d 100644 --- a/man/version-info.xml +++ b/man/version-info.xml @@ -1,9 +1,11 @@ <?xml version="1.0"?> -<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" +<!DOCTYPE refsect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> <!-- SPDX-License-Identifier: LGPL-2.1-or-later --> <refsect1> + <title/> + <para id="v183">Added in version 183.</para> <para id="v184">Added in version 184.</para> <para id="v185">Added in version 185.</para>