Re: [PATCH] docs: man: Unify wording for the description of '--timeout' of daemons

Use a common wording for all various daemons to prevent having to adjust the documentation any further by just outlining that neither clients nor anything else needing the attention of the daemon must be present in order to shut down.

Resolves: https://bugzilla.redhat.com/show_bug.cgi?id=2035985

Signed-off-by: Peter Krempa <pkrempa(a)redhat.com&gt; --- docs/manpages/virtbhyved.rst | 3 ++- docs/manpages/virtinterfaced.rst | 3 ++- docs/manpages/virtlockd.rst | 5 +++-- docs/manpages/virtlogd.rst | 5 +++-- docs/manpages/virtlxcd.rst | 3 ++- docs/manpages/virtnetworkd.rst | 3 ++- docs/manpages/virtnodedevd.rst | 3 ++- docs/manpages/virtnwfilterd.rst | 3 ++- docs/manpages/virtproxyd.rst | 3 ++- docs/manpages/virtqemud.rst | 3 ++- docs/manpages/virtsecretd.rst | 3 ++- docs/manpages/virtstoraged.rst | 3 ++- docs/manpages/virtvboxd.rst | 3 ++- docs/manpages/virtvzd.rst | 3 ++- docs/manpages/virtxend.rst | 3 ++- 15 files changed, 32 insertions(+), 17 deletions(-) diff --git a/docs/manpages/virtbhyved.rst b/docs/manpages/virtbhyved.rst index 9fdaca6da2..2e56514914 100644 --- a/docs/manpages/virtbhyved.rst +++ b/docs/manpages/virtbhyved.rst @@ -61,7 +61,8 @@ Use this name for the PID file, overriding the default value. ``-t``, ``--timeout *SECONDS*`` Exit after timeout period (in seconds), provided there are neither any client -connections nor any running domains. +connections nor any other resources (e.g. running domains, locks, etc.) needing +attention of the daemon. ``-v``, ``--verbose`` diff --git a/docs/manpages/virtinterfaced.rst b/docs/manpages/virtinterfaced.rst index 5777dba638..9b836b0b12 100644 --- a/docs/manpages/virtinterfaced.rst +++ b/docs/manpages/virtinterfaced.rst @@ -83,7 +83,8 @@ Use this name for the PID file, overriding the default value. ``-t``, ``--timeout *SECONDS*`` Exit after timeout period (in seconds), provided there are neither any client -connections nor any running domains. +connections nor any other resources (e.g. running domains, locks, etc.) needing +attention of the daemon. ``-v``, ``--verbose`` diff --git a/docs/manpages/virtlockd.rst b/docs/manpages/virtlockd.rst index 0bbee5a5f7..7ea720d1b7 100644 --- a/docs/manpages/virtlockd.rst +++ b/docs/manpages/virtlockd.rst @@ -50,8 +50,9 @@ Use this configuration file, overriding the default value. ``-t``, ``--timeout`` *SECONDS* -Automatically shutdown after *SECONDS* have elapsed with -no active client or lock. +Exit after timeout period (in seconds), provided there are neither any client +connections nor any other resources (e.g. running domains, locks, etc.) needing +attention of the daemon. ``-p``, ``--pid-file`` *FILE* diff --git a/docs/manpages/virtlogd.rst b/docs/manpages/virtlogd.rst index 1e39ff1b49..0b00595a85 100644 --- a/docs/manpages/virtlogd.rst +++ b/docs/manpages/virtlogd.rst @@ -50,8 +50,9 @@ Use this configuration file, overriding the default value. ``-t``, ``--timeout`` *SECONDS* -Automatically shutdown after *SECONDS* have elapsed with -no active console log. +Exit after timeout period (in seconds), provided there are neither any client +connections nor any other resources (e.g. running domains, locks, etc.) needing +attention of the daemon. ``-p``, ``--pid-file`` *FILE* diff --git a/docs/manpages/virtlxcd.rst b/docs/manpages/virtlxcd.rst index 2e9d8fd14b..4c9a441d0d 100644 --- a/docs/manpages/virtlxcd.rst +++ b/docs/manpages/virtlxcd.rst @@ -83,7 +83,8 @@ Use this name for the PID file, overriding the default value. ``-t``, ``--timeout *SECONDS*`` Exit after timeout period (in seconds), provided there are neither any client -connections nor any running domains. +connections nor any other resources (e.g. running domains, locks, etc.) needing +attention of the daemon. ``-v``, ``--verbose`` diff --git a/docs/manpages/virtnetworkd.rst b/docs/manpages/virtnetworkd.rst index 6d9c5e5fa3..b9409723fb 100644 --- a/docs/manpages/virtnetworkd.rst +++ b/docs/manpages/virtnetworkd.rst @@ -83,7 +83,8 @@ Use this name for the PID file, overriding the default value. ``-t``, ``--timeout *SECONDS*`` Exit after timeout period (in seconds), provided there are neither any client -connections nor any running domains. +connections nor any other resources (e.g. running domains, locks, etc.) needing +attention of the daemon. ``-v``, ``--verbose`` diff --git a/docs/manpages/virtnodedevd.rst b/docs/manpages/virtnodedevd.rst index ef968e486e..1c79529bd8 100644 --- a/docs/manpages/virtnodedevd.rst +++ b/docs/manpages/virtnodedevd.rst @@ -82,7 +82,8 @@ Use this name for the PID file, overriding the default value. ``-t``, ``--timeout *SECONDS*`` Exit after timeout period (in seconds), provided there are neither any client -connections nor any running domains. +connections nor any other resources (e.g. running domains, locks, etc.) needing +attention of the daemon. ``-v``, ``--verbose`` diff --git a/docs/manpages/virtnwfilterd.rst b/docs/manpages/virtnwfilterd.rst index 4faa6b225d..0690c795d9 100644 --- a/docs/manpages/virtnwfilterd.rst +++ b/docs/manpages/virtnwfilterd.rst @@ -83,7 +83,8 @@ Use this name for the PID file, overriding the default value. ``-t``, ``--timeout *SECONDS*`` Exit after timeout period (in seconds), provided there are neither any client -connections nor any running domains. +connections nor any other resources (e.g. running domains, locks, etc.) needing +attention of the daemon. ``-v``, ``--verbose`` diff --git a/docs/manpages/virtproxyd.rst b/docs/manpages/virtproxyd.rst index 0366935b9a..918aae6c2b 100644 --- a/docs/manpages/virtproxyd.rst +++ b/docs/manpages/virtproxyd.rst @@ -105,7 +105,8 @@ Use this name for the PID file, overriding the default value. ``-t``, ``--timeout *SECONDS*`` Exit after timeout period (in seconds), provided there are neither any client -connections nor any running domains. +connections nor any other resources (e.g. running domains, locks, etc.) needing +attention of the daemon. ``-v``, ``--verbose`` diff --git a/docs/manpages/virtqemud.rst b/docs/manpages/virtqemud.rst index ea8d6e3105..f1f1710393 100644 --- a/docs/manpages/virtqemud.rst +++ b/docs/manpages/virtqemud.rst @@ -83,7 +83,8 @@ Use this name for the PID file, overriding the default value. ``-t``, ``--timeout *SECONDS*`` Exit after timeout period (in seconds), provided there are neither any client -connections nor any running domains. +connections nor any other resources (e.g. running domains, locks, etc.) needing +attention of the daemon. ``-v``, ``--verbose`` diff --git a/docs/manpages/virtsecretd.rst b/docs/manpages/virtsecretd.rst index fffb3a24f6..f35bfb6b5a 100644 --- a/docs/manpages/virtsecretd.rst +++ b/docs/manpages/virtsecretd.rst @@ -82,7 +82,8 @@ Use this name for the PID file, overriding the default value. ``-t``, ``--timeout *SECONDS*`` Exit after timeout period (in seconds), provided there are neither any client -connections nor any running domains. +connections nor any other resources (e.g. running domains, locks, etc.) needing +attention of the daemon. ``-v``, ``--verbose`` diff --git a/docs/manpages/virtstoraged.rst b/docs/manpages/virtstoraged.rst index 4ceae57e40..ae25a90040 100644 --- a/docs/manpages/virtstoraged.rst +++ b/docs/manpages/virtstoraged.rst @@ -83,7 +83,8 @@ Use this name for the PID file, overriding the default value. ``-t``, ``--timeout *SECONDS*`` Exit after timeout period (in seconds), provided there are neither any client -connections nor any running domains. +connections nor any other resources (e.g. running domains, locks, etc.) needing +attention of the daemon. ``-v``, ``--verbose`` diff --git a/docs/manpages/virtvboxd.rst b/docs/manpages/virtvboxd.rst index d7339d99f2..0be68d87b8 100644 --- a/docs/manpages/virtvboxd.rst +++ b/docs/manpages/virtvboxd.rst @@ -81,7 +81,8 @@ Use this name for the PID file, overriding the default value. ``-t``, ``--timeout *SECONDS*`` Exit after timeout period (in seconds), provided there are neither any client -connections nor any running domains. +connections nor any other resources (e.g. running domains, locks, etc.) needing +attention of the daemon. ``-v``, ``--verbose`` diff --git a/docs/manpages/virtvzd.rst b/docs/manpages/virtvzd.rst index 42dfa263e4..d2d6fecce6 100644 --- a/docs/manpages/virtvzd.rst +++ b/docs/manpages/virtvzd.rst @@ -83,7 +83,8 @@ Use this name for the PID file, overriding the default value. ``-t``, ``--timeout *SECONDS*`` Exit after timeout period (in seconds), provided there are neither any client -connections nor any running domains. +connections nor any other resources (e.g. running domains, locks, etc.) needing +attention of the daemon. ``-v``, ``--verbose`` diff --git a/docs/manpages/virtxend.rst b/docs/manpages/virtxend.rst index b08346b489..d12196956c 100644 --- a/docs/manpages/virtxend.rst +++ b/docs/manpages/virtxend.rst @@ -83,7 +83,8 @@ Use this name for the PID file, overriding the default value. ``-t``, ``--timeout *SECONDS*`` Exit after timeout period (in seconds), provided there are neither any client -connections nor any running domains. +connections nor any other resources (e.g. running domains, locks, etc.) needing +attention of the daemon. ``-v``, ``--verbose`` -- 2.34.1