From: Pádraig Brady <P@draigBrady.com>
Date: Fri, 12 Aug 2022 12:40:00 +0000 (+0100)
Subject: doc: ls: clarify description of timestamps
X-Git-Tag: v9.2~163
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=35fbc51d3ff0946b677732a1dbd0b715267b1855;p=thirdparty%2Fcoreutils.git

doc: ls: clarify description of timestamps

* src/ls.c (usage): Don't mention "modification" in the
description of ctime (-c), as it's confusing with mtime.
Mention "metadata" when discussing "change" time to
disambiguate from data change time.
* doc/coreutils.texi (ls invocation): State that --time=creation
falls back to using mtime where not available.
---

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 71ccc64edc..35f90d4172 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -8031,7 +8031,8 @@ sort according to the atime.
 @opindex --time
 @opindex birth time@r{, printing or sorting files by}
 @opindex creation timestamp@r{, printing or sorting files by}
-In long format, print the file creation timestamp if available.
+In long format, print the file creation timestamp if available,
+falling back to the file modification timestamp (mtime) if not.
 When sorting by time or when not using long format,
 sort according to the birth time.
 @xref{File timestamps}.
diff --git a/src/ls.c b/src/ls.c
index d48892be7c..cce1c6cb1a 100644
--- a/src/ls.c
+++ b/src/ls.c
@@ -5423,7 +5423,7 @@ Sort entries alphabetically if none of -cftuvSUX nor --sort is specified.\n\
 "), stdout);
       fputs (_("\
   -c                         with -lt: sort by, and show, ctime (time of last\n\
-                             modification of file status information);\n\
+                             change of file status information);\n\
                              with -l: show ctime and sort by name;\n\
                              otherwise: sort by ctime, newest first\n\
 \n\
@@ -5557,7 +5557,7 @@ Sort entries alphabetically if none of -cftuvSUX nor --sort is specified.\n\
       fputs (_("\
       --time=WORD            change the default of using modification times;\n\
                                access time (-u): atime, access, use;\n\
-                               change time (-c): ctime, status;\n\
+                               metadata change time (-c): ctime, status;\n\
                                birth time: birth, creation;\n\
                              with -l, WORD determines which time to show;\n\
                              with --sort=time, sort by WORD (newest first)\n\