summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorPádraig Brady <P@draigBrady.com>2022-08-12 14:16:14 +0100
committerPádraig Brady <P@draigBrady.com>2022-08-13 13:48:24 +0100
commita88b666bea3916b978373f89b5f11f3d5b7157a6 (patch)
treefb1433c0aa09530eb14ab9e884db5589be678b68 /doc
parent35fbc51d3ff0946b677732a1dbd0b715267b1855 (diff)
downloadcoreutils-a88b666bea3916b978373f89b5f11f3d5b7157a6.tar.gz
ls: support explicit --time=modification selection
* src/ls.c [time_args]: Add support for explicit 'mtime' or 'modification' arguments to --time. * tests/misc/ls-time.sh: Add explicit --time=mtime usage. * doc/coreutils.texi (ls invocation): Describe --time=mtime. * NEWS: Mention the new feature.
Diffstat (limited to 'doc')
-rw-r--r--doc/coreutils.texi11
1 files changed, 11 insertions, 0 deletions
diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 35f90d417..c034a84dd 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -8026,6 +8026,17 @@ When sorting by time or when not using long format,
sort according to the atime.
@xref{File timestamps}.
+@item --time=mtime
+@itemx --time=modification
+@opindex --time
+@opindex data modification time@r{, printing or sorting files by}
+@opindex mtime@r{, printing or sorting files by}
+This is the default timestamp display and sorting mode.
+In long format, print the last data modification timestamp (the mtime).
+When sorting by time or when not using long format,
+sort according to the mtime.
+@xref{File timestamps}.
+
@item --time=birth
@itemx --time=creation
@opindex --time