[src/trunk]: src/external/gpl2/xcvs/dist/doc document -t for update

[christos <christos%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/116722005525
branches:  trunk
changeset: 349745:116722005525
user:      christos <christos%NetBSD.org@localhost>
date:      Wed Dec 21 21:26:28 2016 +0000

description:
document -t for update

diffstat:

 external/gpl2/xcvs/dist/doc/cvs.1 |  15 ++++++++++++++-
 1 files changed, 14 insertions(+), 1 deletions(-)

diffs (32 lines):

diff -r 9548f3ba6f07 -r 116722005525 external/gpl2/xcvs/dist/doc/cvs.1
--- a/external/gpl2/xcvs/dist/doc/cvs.1 Wed Dec 21 18:01:21 2016 +0000
+++ b/external/gpl2/xcvs/dist/doc/cvs.1 Wed Dec 21 21:26:28 2016 +0000
@@ -3664,7 +3664,7 @@
 .IX "update (subcommand)"
 .SP
 .IP "\(bu" 2
-update [-ACdflPpR] [-I name] [-j rev [-j rev]] [-k kflag] [-r tag[:date] | -D date] [-W spec] files\&...
+update [-ACdflPpRt] [-I name] [-j rev [-j rev]] [-k kflag] [-r tag[:date] | -D date] [-W spec] files\&...
 .IP "\(bu" 2
 Requires: repository, working directory.
 .IP "\(bu" 2
@@ -3724,6 +3724,19 @@
 Prune empty directories.  See see node `Moving directories\(aq in the CVS manual.
 .SP
 .IP "" 0
+\fB-t\fR
+.IP "" 2
+Preserve source timestamps.  Unlike \fBcheckout\fR where files are created
+using the original timestamp of the file in the repository, \fBupdate\fR
+updates files using the current time of the machine.  This is convenient
+because updated files appear newer than any other files on the system so
+.BR make ( 1 )
+knows that are their corresponding built artifacts are out of date and
+they will get rebuilt.  The \fB-t\fR flag instead preserves the timestamps
+of the original repository files, behaving exactly like \fBcheckout\fR.
+This is useful for maintaining a tree in the original checked-out state.
+.SP
+.IP "" 0
 \fB-p\fR
 .IP "" 2
 Pipe files to the standard output.