From 69e796de6c518d7739229ab1df6f04d390c07527 Mon Sep 17 00:00:00 2001 From: Jim Meyering Date: Thu, 28 Feb 2002 08:19:50 +0000 Subject: (Formatting file timestamps): Document new time-formatting method: --time-style=+FORMAT. --- doc/coreutils.texi | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) (limited to 'doc/coreutils.texi') diff --git a/doc/coreutils.texi b/doc/coreutils.texi index 11b146988..d7d096292 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 -- cgit v1.2.3-54-g00ecf