From: Paul Eggert <eggert@cs.ucla.edu>
Date: Tue, 18 Jun 2019 07:31:43 +0000 (-0700)
Subject: doc: mention ls -l user/group justification
X-Git-Tag: v8.32~69
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=a3a454b9d9029115917ff31b66f424d6c5de9300;p=thirdparty%2Fcoreutils.git

doc: mention ls -l user/group justification

* doc/coreutils.texi (What information is listed):
Document justification of user and group columns in ls -l output
(Bug#36220).
---

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 0b71bedb46..3c2eb97507 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -7662,7 +7662,10 @@ In addition to the name of each file, print the file type, file mode bits,
 number of hard links, owner name, group name, size, and
 timestamp (@pxref{Formatting file timestamps}), normally
 the modification timestamp (the mtime, @pxref{File timestamps}).
-Print question marks for information that
+If the owner or group name cannot be determined, print
+the owner or group ID instead, right-justified as a cue
+that it is a number rather than a textual name.
+Print question marks for other information that
 cannot be determined.
 
 Normally the size is printed as a byte count without punctuation, but
@@ -7772,7 +7775,8 @@ is marked with a @samp{+} character.
 @cindex numeric uid and gid
 @cindex numeric user and group IDs
 Produce long format directory listings, but
-display numeric user and group IDs instead of the owner and group names.
+display right-justified numeric user and group IDs
+instead of left-justified owner and group names.
 
 @item -o
 @opindex -o