summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGisle Aas <gisle@aas.no>2003-10-22 22:33:43 -0700
committerAbhijit Menon-Sen <ams@wiw.org>2003-10-23 12:53:03 +0000
commit017471c2a0096fb989b7aa58ca42ee0bdce5a768 (patch)
tree44a6e9b75dfa04e93ba26b2ca1104ae05c709296
parentb5a07b4260660d30b43ebb412a4fb3dc950fb2a8 (diff)
downloadperl-017471c2a0096fb989b7aa58ca42ee0bdce5a768.tar.gz
utime documentation
Message-Id: <lrekx4jfq0.fsf@caliper.activestate.com> p4raw-id: //depot/perl@21523
-rw-r--r--pod/perlfunc.pod19
1 files changed, 13 insertions, 6 deletions
diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod
index 4d4efc53df..6b093eb790 100644
--- a/pod/perlfunc.pod
+++ b/pod/perlfunc.pod
@@ -6260,12 +6260,8 @@ to the current time. For example, this code has the same effect as the
Unix touch(1) command when the files I<already exist>.
#!/usr/bin/perl
- $now = time;
- utime $now, $now, @ARGV;
-
-B<Note:> Under NFS, touch(1) uses the time of the NFS server, not
-the time of the local machine. If there is a time synchronization
-problem, the NFS server and local machine will have different times.
+ $atime = $mtime = time;
+ utime $atime, $mtime, @ARGV;
Since perl 5.7.2, if the first two elements of the list are C<undef>, then
the utime(2) function in the C library will be called with a null second
@@ -6275,6 +6271,17 @@ above.)
utime undef, undef, @ARGV;
+Under NFS this will use the time of the NFS server, not the time of
+the local machine. If there is a time synchronization problem, the
+NFS server and local machine will have different times. The Unix
+touch(1) command will in fact normally use this form instead of the
+one shown in the first example.
+
+Note that only passing one of the first two elements as C<undef> will
+be equivalent of passing it as 0 and will not have the same effect as
+described when they are both C<undef>. This case will also trigger an
+uninitialized warning.
+
=item values HASH
Returns a list consisting of all the values of the named hash.