From: Jim Meyering <jim@meyering.net>
Date: Thu, 28 Feb 2002 08:19:50 +0000 (+0000)
Subject: (Formatting file timestamps): Document new
X-Git-Tag: FILEUTILS-4_1_6~47
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=69e796de6c518d7739229ab1df6f04d390c07527;p=thirdparty%2Fcoreutils.git

(Formatting file timestamps): Document new
time-formatting method: --time-style=+FORMAT.
---

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 11b1469886..d7d0962926 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -5382,6 +5382,22 @@ set.
 Use traditional @sc{posix}-locale dates like @samp{May 14@ @ 2001} and
 @samp{May 14 23:45} unless the user specifies a non-@sc{posix} locale,
 in which case use @sc{iso}-style dates.  This is the default.
+
+@item +@var{format}
+Use @var{format} for dates, where @var{format} is interpreted like the
+format argument of @command{date} (@pxref{date invocation}).  If
+@var{format} contains two format strings separated by a newline, the
+former is used for non-recent files and the latter for recent files;
+if you want the columns to line up, you may need to append trailing
+spaces to one of the two formats.  For example, the following two
+@command{ls} invocations are equivalent:
+
+@example
+newline='
+'
+ls -l --time-style=iso
+ls -l --time-style=+"%Y-%m-%d $@{newline@}%m-%d %H:%M"
+@end example
 @end table
 @end table