doc: fix ambiguities in logname(1) and whoami(1)

* doc/coreutils.texi (whoami invocation): Clarify it prints names,
not numeric IDs.
* man/whoami.x: Likewise.
* man/logname.x: Reference getlogin(3).
* src/logname.c: Clarify that it prints the login name,
rather than the name of the effective user ID.

Fixes https://bugs.gnu.org/48894

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index d77bcc0c236d45dab2e1d2c41a0e08d54a9fc03d..882aa26aba0771f6f5f0d8c19bf1a3a00ab297d4 100644 (file)
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -15643,10 +15643,10 @@ options}.
 
 
 @node whoami invocation
-@section @command{whoami}: Print effective user ID
+@section @command{whoami}: Print effective user name
 
 @pindex whoami
-@cindex effective user ID, printing
+@cindex effective user name, printing
 @cindex printing the effective user ID
 
 @command{whoami} prints the user name associated with the current

diff --git a/man/logname.x b/man/logname.x
index 997a1b7bcaf990edc5d44bac030fbb384f843270..83dbc066f976f6370b6d2e3b128c325773d2f75b 100644 (file)
--- a/man/logname.x
+++ b/man/logname.x
@@ -2,3 +2,5 @@
 logname \- print user\'s login name
 [DESCRIPTION]
 .\" Add any additional description here
+[SEE ALSO]
+getlogin(3)

diff --git a/man/whoami.x b/man/whoami.x
index 7ee371a3de898182f6c91bb02eb400709dcf4422..e7521e5cb4d80d1773dec89b6b9fcbaf968f1b86 100644 (file)
--- a/man/whoami.x
+++ b/man/whoami.x
@@ -1,4 +1,4 @@
 [NAME]
-whoami \- print effective userid
+whoami \- print effective user name
 [DESCRIPTION]
 .\" Add any additional description here

diff --git a/src/logname.c b/src/logname.c
index cf98bfc66652e12a475e4f9d7d35aa24a87a435c..8d1b0f18d67dee0de1f38d0cc9908cd125dd4da3 100644 (file)
--- a/src/logname.c
+++ b/src/logname.c
@@ -38,7 +38,7 @@ usage (int status)
     {
       printf (_("Usage: %s [OPTION]\n"), program_name);
       fputs (_("\
-Print the name of the current user.\n\
+Print the user's login name.\n\
 \n\
 "), stdout);
       fputs (HELP_OPTION_DESCRIPTION, stdout);