[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH] doc: ls: clarify description of timestamps
From: |
Pádraig Brady |
Subject: |
[PATCH] doc: ls: clarify description of timestamps |
Date: |
Fri, 12 Aug 2022 13:43:10 +0100 |
* src/ls.c (usage): Don't mention "modification" in the
description of ctime (-c), as it's confusing with mtime.
* doc/coreutils.texi (ls invocation): State that --time=creation
falls back to using mtime where not available.
---
doc/coreutils.texi | 3 ++-
src/ls.c | 2 +-
2 files changed, 3 insertions(+), 2 deletions(-)
diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 71ccc64ed..35f90d417 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 d48892be7..2c9a58398 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\
--
2.26.2
- [PATCH] doc: ls: clarify description of timestamps,
Pádraig Brady <=