summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorPaul Eggert <eggert@cs.ucla.edu>2005-06-23 22:37:58 +0000
committerPaul Eggert <eggert@cs.ucla.edu>2005-06-23 22:37:58 +0000
commit7461cd03b589202190f388f50dd0ca923fa045c4 (patch)
tree229d9cafb6c3865319be1daa5c2d923e9254c504 /doc
parent638e81b53735902ed578b5ab0e17a6c3ad0d5fb8 (diff)
downloadcoreutils-7461cd03b589202190f388f50dd0ca923fa045c4.tar.xz
(ls invocation): Fix typo: --time=use is
equivalent to --time=atime, not --time=ctime. (ls invocation, du invocation): Fix typo: --time-style=long-iso is equivalent to a time style with a leading "+". (du invocation): --last-time is now --time. --time-style no longer implies --time. The locale and posix- stuff now works only for TIME_STYLE, not for --time-style. Give equivalent format for --time-style=iso.
Diffstat (limited to 'doc')
-rw-r--r--doc/coreutils.texi101
1 files changed, 36 insertions, 65 deletions
diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 75910a597..3af02df2a 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -5677,7 +5677,6 @@ it outputs. By default, sorting is done by character code
@item -c
@itemx --time=ctime
@itemx --time=status
-@itemx --time=use
@opindex -c
@opindex --time
@opindex ctime@r{, printing or sorting by}
@@ -5724,6 +5723,7 @@ Sort by modification time (the @samp{mtime} in the inode), newest first.
@item -u
@itemx --time=atime
@itemx --time=access
+@itemx --time=use
@opindex -u
@opindex --time
@opindex use time@r{, printing or sorting files by}
@@ -6009,7 +6009,7 @@ uses the full timestamp to determine whether a file is out of date.
List @acronym{ISO} 8601 date and time in minutes, e.g.,
@samp{2002-03-30 23:45}. These timestamps are shorter than
@samp{full-iso} timestamps, and are usually good enough for everyday
-work. This style is equivalent to @samp{%Y-%m-%d %H:%M}.
+work. This style is equivalent to @samp{+%Y-%m-%d %H:%M}.
@item iso
List @acronym{ISO} 8601 dates for non-recent timestamps (e.g.,
@@ -9004,30 +9004,6 @@ Dereference symbolic links (show the disk space used by the file
or directory that the link points to instead of the space used by
the link).
-@itemx --last-time
-@opindex --last-time
-@cindex last modified dates, displaying in @command{du}
-Show time of the most recent modification of any file in the directory,
-or any of its subdirectories.
-
-@itemx --last-time=ctime
-@itemx --last-time=status
-@itemx --last-time=use
-@opindex --last-time
-@opindex ctime@r{, show the most recent}
-@opindex status time@r{, show the most recent}
-@opindex use time@r{, show the most recent}
-Show the most recent status change time (the @samp{ctime} in the inode) of
-any file in the directory, instead of the modification time.
-
-@itemx --last-time=atime
-@itemx --last-time=access
-@opindex --last-time
-@opindex atime@r{, show the most recent}
-@opindex access time@r{, show the most recent}
-Show the most recent access time (the @samp{atime} in the inode) of
-any file in the directory, instead of the modification time.
-
@item -P
@itemx --no-dereference
@opindex -P
@@ -9073,12 +9049,35 @@ Display only a total for each argument.
Report the size of each directory separately, not including the sizes
of subdirectories.
+@itemx --time
+@opindex --time
+@cindex last modified dates, displaying in @command{du}
+Show time of the most recent modification of any file in the directory,
+or any of its subdirectories.
+
+@itemx --time=ctime
+@itemx --time=status
+@itemx --time=use
+@opindex --time
+@opindex ctime@r{, show the most recent}
+@opindex status time@r{, show the most recent}
+@opindex use time@r{, show the most recent}
+Show the most recent status change time (the @samp{ctime} in the inode) of
+any file in the directory, instead of the modification time.
+
+@itemx --time=atime
+@itemx --time=access
+@opindex --time
+@opindex atime@r{, show the most recent}
+@opindex access time@r{, show the most recent}
+Show the most recent access time (the @samp{atime} in the inode) of
+any file in the directory, instead of the modification time.
+
@item --time-style=@var{style}
@opindex --time-style
@cindex time style
-Implicity selects the option @option{--last-time} to show last modified
-date if an explicit @option{--last-time} option has not been selected.
-List timestamps in style @var{style}. The @var{style} should
+List timestamps in style @var{style}. This option has an effect only if
+the @option{--time} option is also specified. The @var{style} should
be one of the following:
@table @samp
@@ -9101,49 +9100,21 @@ format with nanosecond precision, e.g., @samp{2002-03-30
List @acronym{ISO} 8601 date and time in minutes, e.g.,
@samp{2002-03-30 23:45}. These timestamps are shorter than
@samp{full-iso} timestamps, and are usually good enough for everyday
-work. This style is equivalent to @samp{%Y-%m-%d %H:%M}.
+work. This style is equivalent to @samp{+%Y-%m-%d %H:%M}.
@item iso
-List @acronym{ISO} 8601 dates for timestamps
-
-@item locale
-@vindex LC_TIME
-List timestamps in a locale-dependent form. For example, a Finnish
-locale might list timestamps like @samp{maalis 30@ @ 2002}.
-Locale-dependent timestamps typically consume more space than @samp{iso}
-timestamps and are harder for programs to parse because locale
-conventions vary so widely, but they are easier for many people to read.
-
-The @env{LC_TIME} locale category specifies the timestamp format. The
-default @acronym{POSIX} locale uses timestamps like @samp{Mar 30@
-@ 2002}; in this locale, the following two @command{du} invocations are
-equivalent:
-
-@example
-du --last-time --time-style="+%b %e %Y"
-du --last-time --time-style="locale"
-@end example
-
-Other locales behave differently. For example, in a German locale,
-@option{--time-style="locale"} might be equivalent to
-@option{--time-style="+%e. %b %Y"}
-and might generate timestamps like @samp{30. M@"ar 2002@ }.
-
-@item posix-@var{style}
-@vindex LC_TIME
-List @acronym{POSIX}-locale timestamps if the @env{LC_TIME} locale
-category is @acronym{POSIX}, @var{style} timestamps otherwise. For
-example, the default style, which is @samp{posix-long-iso}, lists
-timestamps like @samp{Mar 30@ @ 2002} when in
-the @acronym{POSIX} locale, and like @samp{2002-03-30 23:45} otherwise.
+List @acronym{ISO} 8601 dates for timestamps, e.g., @samp{2002-03-30}.
+This style is equivalent to @samp{+%Y-%m-%d}.
@end table
@vindex TIME_STYLE
You can specify the default value of the @option{--time-style} option
with the environment variable @env{TIME_STYLE}; if @env{TIME_STYLE} is not set
-the default style is @samp{posix-long-iso}. If @env{TIME_STYLE} contains two
-styles, separated by a newline (for @command{ls}), the @command{du} uses only
-the first of the two styles.
+the default style is @samp{long-iso}. For compatibility with @command{ls},
+if @env{TIME_STYLE} begins with @samp{+} and contains a newline,
+the newline and any later characters are ignored; if @env{TIME_STYLE}
+begins with @samp{posix-} the @samp{posix-} is ignored; and if
+@env{TIME_STYLE} is @samp{locale} it is ignored.
@item -x
@itemx --one-file-system