From: Jim Meyering <jim@meyering.net>
Date: Fri, 16 Jan 2004 07:53:19 +0000 (+0000)
Subject: (touch invocation): touch -r and -d can now
X-Git-Tag: v5.1.1~32
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=7430e918cb579aa0d340e12b7dfe003d7dca6746;p=thirdparty%2Fcoreutils.git

(touch invocation): touch -r and -d can now
both be specified, with -r specifying the origin for -d.
---

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 416111823f..aace0f88fd 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -8126,6 +8126,11 @@ Change the modification time only.
 @opindex -r
 @opindex --reference
 Use the times of the reference @var{file} instead of the current time.
+If this option is combined with the @option{--date=@var{time}}
+(@option{-d @var{time}}) option, the reference @var{file}'s time is
+the origin for any relative @var{time}s given, but is otherwise ignored.
+For example, @samp{-r foo -d '-5 seconds'} specifies a time stamp
+equal to five seconds before the corresponding time stamp for @file{foo}.
 
 @item -t [[CC]YY]MMDDhhmm[.ss]
 Use the argument (optional four-digit or two-digit years, months,