summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorJim Meyering <jim@meyering.net>2002-02-11 23:25:34 +0000
committerJim Meyering <jim@meyering.net>2002-02-11 23:25:34 +0000
commita4376b2603553cad80c26278343fe0ba66c765b0 (patch)
treeb6883b1afd4310cf848d34cdc237b87910fd6ee2 /doc
parent28bcd7730222c9b40eddef8fe84dc687033de340 (diff)
downloadcoreutils-a4376b2603553cad80c26278343fe0ba66c765b0.tar.xz
Add more support for POSIX 1003.1-2001, which requires removal
for support of obsolete "-DIGITS" option syntax in nice, and which prohibits options with optional arguments like date's -I option. Document this.
Diffstat (limited to 'doc')
-rw-r--r--doc/coreutils.texi19
1 files changed, 14 insertions, 5 deletions
diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 82770fe15..da8a0528c 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -9973,13 +9973,13 @@ input. This is useful when you have many dates to process, because the
system overhead of starting up the @code{date} executable many times can
be considerable.
-@item -I[@var{timespec}]
+@item -I @var{timespec}
@itemx --iso-8601[=@var{timespec}]
-@opindex -I[@var{timespec}]
+@opindex -I @var{timespec}
@opindex --iso-8601[=@var{timespec}]
Display the date using the ISO 8601 format, @samp{%Y-%m-%d}.
-The optional argument @var{timespec} specifies the number of additional
+The argument @var{timespec} specifies the number of additional
terms of the time to include. It can be one of the following:
@table @samp
@item auto
@@ -9998,6 +9998,12 @@ Append the hours, minutes, and seconds.
If showing any time terms, then include the time zone using the format
@samp{%z}.
+If @var{timespec} is omitted with @option{--iso-8601}, the default is
+@samp{auto}. On older systems, @sc{gnu} @command{date} instead
+supports an obsolete option @option{-I[@var{timespec}]}, where
+@var{timespec} defaults to @samp{auto}. Newer systems do not support
+@option{-I} without an argument; use @option{--iso-8601} instead.
+
@item -R
@itemx --rfc-822
@opindex -R
@@ -10472,12 +10478,15 @@ The program accepts the following option. Also see @ref{Common options}.
@table @samp
@item -n @var{adjustment}
-@itemx -@var{adjustment}
@itemx --adjustment=@var{adjustment}
@opindex -n
@opindex --adjustment
-@opindex -@var{adjustment}
Add @var{adjustment} instead of 10 to the command's priority.
+
+On older systems, @command{nice} supports an obsolete option
+@option{-@var{adjustment}}. Newer systems do not support this; use
+@option{-n @var{adjustment}} instead.
+
@end table