From: Pádraig Brady <P@draigBrady.com>
Date: Tue, 20 Jan 2026 17:43:32 +0000 (+0000)
Subject: doc: who: document --users in manual
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=9a10b354ec0a60f3d460feb4ae662e5e71d033ef;p=thirdparty%2Fcoreutils.git

doc: who: document --users in manual

* doc/coreutils.texi (who invocation): Mention that --users
is equivalent to -u.
* src/who.c (usage): Mention -u shows idle time.
---

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 6a9fc54389..cea9efb842 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -15707,7 +15707,7 @@ Overrides all other options.
 Print the current (and maybe previous) run-level of the init process.
 
 @optItem{who,-s,}
-@optItem{who,--short,}
+@optItemx{who,--short,}
 Ignored; for compatibility with other versions of @command{who}.
 
 @optItem{who,-t,}
@@ -15715,6 +15715,7 @@ Ignored; for compatibility with other versions of @command{who}.
 Print last system clock change.
 
 @optItem{who,-u,}
+@optItemx{who,--users,}
 @cindex idle time
 After the login time, print the number of hours and minutes that the
 user has been idle.  @samp{.} means the user was active in the last minute.
diff --git a/src/who.c b/src/who.c
index dbf67297f7..65c9e67888 100644
--- a/src/who.c
+++ b/src/who.c
@@ -679,7 +679,7 @@ Print information about users who are currently logged in.\n\
   -T, -w, --mesg    add user's message status as +, - or ?\n\
 "));
       oputs (_("\
-  -u, --users       list users logged in\n\
+  -u, --users       list users logged in, including idle time\n\
 "));
       oputs (_("\
       --message     same as -T\n\