From 028de7292d6923c4b77c5d03d47097aeda24fc1d Mon Sep 17 00:00:00 2001
From: =?utf8?q?J=C3=B6rg=20Behrmann?= <behrmann@physik.fu-berlin.de>
Date: Tue, 13 May 2025 17:19:39 +0200
Subject: [PATCH] man, systemctl: document --what=help

---
 man/systemctl.xml         | 4 ++++
 src/systemctl/systemctl.c | 2 +-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/man/systemctl.xml b/man/systemctl.xml
index aac17ae01ac..ed0cafff8b4 100644
--- a/man/systemctl.xml
+++ b/man/systemctl.xml
@@ -616,6 +616,10 @@ Jan 12 10:46:45 example.com bluetoothd[8900]: gatt-time-server: Input/output err
                     <entry><literal>all</literal></entry>
                     <entry>All of the above</entry>
                   </row>
+                  <row>
+                    <entry><literal>help</literal></entry>
+                    <entry>Show the supported values and exit</entry>
+                  </row>
                 </tbody>
               </tgroup>
             </table>
diff --git a/src/systemctl/systemctl.c b/src/systemctl/systemctl.c
index fdbde7dc5e7..55fa386e7a4 100644
--- a/src/systemctl/systemctl.c
+++ b/src/systemctl/systemctl.c
@@ -958,7 +958,7 @@ static int systemctl_parse_argv(int argc, char *argv[]) {
 
                 case ARG_WHAT:
                         if (isempty(optarg))
-                                return log_error_errno(SYNTHETIC_ERRNO(EINVAL), "--what= requires arguments.");
+                                return log_error_errno(SYNTHETIC_ERRNO(EINVAL), "--what= requires arguments (see --what=help).");
 
                         for (const char *p = optarg;;) {
                                 _cleanup_free_ char *k = NULL;
-- 
2.47.3