Blame SOURCES/0230-man-information-about-available-properties.patch

17b0f1
From 285bd714e050c189f6e5e9aa6b59173997ae550e Mon Sep 17 00:00:00 2001
17b0f1
From: =?UTF-8?q?Zbigniew=20J=C4=99drzejewski-Szmek?= <zbyszek@in.waw.pl>
17b0f1
Date: Mon, 29 Jun 2015 20:19:56 -0400
17b0f1
Subject: [PATCH] man: information about available properties
17b0f1
17b0f1
https://bugzilla.redhat.com/show_bug.cgi?id=1144496
17b0f1
(cherry picked from commit ea539eb65950bea7a9734424e660ef84f6f30e6c)
17b0f1
17b0f1
Cherry-picked from: ea539eb
17b0f1
Resolves: #1222517
17b0f1
---
17b0f1
 man/systemctl.xml | 28 +++++++++++++++++++++++-----
17b0f1
 1 file changed, 23 insertions(+), 5 deletions(-)
17b0f1
17b0f1
diff --git a/man/systemctl.xml b/man/systemctl.xml
17b0f1
index 44ec0d7bcf..6b29b8cd03 100644
17b0f1
--- a/man/systemctl.xml
17b0f1
+++ b/man/systemctl.xml
17b0f1
@@ -111,12 +111,30 @@
17b0f1
 
17b0f1
         <listitem>
17b0f1
           <para>When showing unit/job/manager properties with the
17b0f1
-          <command>show</command> command, limit display to certain
17b0f1
-          properties as specified as argument. If not specified, all
17b0f1
-          set properties are shown. The argument should be a
17b0f1
+          <command>show</command> command, limit display to properties
17b0f1
+          specified in the argument. The argument should be a
17b0f1
           comma-separated list of property names, such as
17b0f1
-          <literal>MainPID</literal>. If specified more than once, all
17b0f1
-          properties with the specified names are shown.</para>
17b0f1
+          <literal>MainPID</literal>. Unless specified, all known
17b0f1
+          properties are shown. If specified more than once, all
17b0f1
+          properties with the specified names are shown. Shell
17b0f1
+          completion is implemented for property names.</para>
17b0f1
+
17b0f1
+          <para>For the manager itself,
17b0f1
+          <command>systemctl show</command> will show all available
17b0f1
+          properties. Those properties are documented in
17b0f1
+          <citerefentry><refentrytitle>systemd-system.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
17b0f1
+          </para>
17b0f1
+
17b0f1
+          <para>Properties for units vary by unit type, so showing any
17b0f1
+          unit (even a non-existent one) is a way to list properties
17b0f1
+          pertaining to this type. Similarly showing any job will list
17b0f1
+          properties pertaining to all jobs. Properties for units are
17b0f1
+          documented in
17b0f1
+          <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
17b0f1
+          and the pages for individual unit types
17b0f1
+          <citerefentry><refentrytitle>systemd.service</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
17b0f1
+          <citerefentry><refentrytitle>systemd.socket</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
17b0f1
+          etc.</para>
17b0f1
         </listitem>
17b0f1
       </varlistentry>
17b0f1