From 43de627a272ccff6027b753c68793f268c691699 Mon Sep 17 00:00:00 2001
From: Kalle Sommer Nielsen <kalle@php.net>
Date: Thu, 21 Aug 2008 23:50:27 +0000
Subject: [PATCH] Added note on fileatime, filectime, filemtime, stat and touch
 regrading time resolution from file system to another

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@265254 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/filesystem/functions/fileatime.xml | 7 ++++++-
 reference/filesystem/functions/filectime.xml | 7 ++++++-
 reference/filesystem/functions/filemtime.xml | 7 ++++++-
 reference/filesystem/functions/stat.xml      | 7 ++++++-
 reference/filesystem/functions/touch.xml     | 7 ++++++-
 5 files changed, 30 insertions(+), 5 deletions(-)

diff --git a/reference/filesystem/functions/fileatime.xml b/reference/filesystem/functions/fileatime.xml
index 42f1a73cf7..7536b4f69f 100644
--- a/reference/filesystem/functions/fileatime.xml
+++ b/reference/filesystem/functions/fileatime.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.10 $ -->
+<!-- $Revision: 1.11 $ -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.fileatime">
  <refnamediv>
   <refname>fileatime</refname>
@@ -79,6 +79,11 @@ if (file_exists($filename)) {
     common example. On such filesystems this function will be useless.
    </para>
   </note>
+  <note>
+   <para>
+    Note that the time resolution may be different from the file system to another.
+   </para>
+  </note>
   &note.clearstatcache;
   &tip.fopen-wrapper.stat;
  </refsect1>
diff --git a/reference/filesystem/functions/filectime.xml b/reference/filesystem/functions/filectime.xml
index 496477beb1..ad8b7f5e34 100644
--- a/reference/filesystem/functions/filectime.xml
+++ b/reference/filesystem/functions/filectime.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.11 $ -->
+<!-- $Revision: 1.12 $ -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.filectime">
  <refnamediv>
   <refname>filectime</refname>
@@ -83,6 +83,11 @@ if (file_exists($filename)) {
     time for Unix files in most Unix filesystems.
    </para>
   </note>
+  <note>
+   <para>
+    Note that the time resolution may be different from the file system to another.
+   </para>
+  </note>
   &note.clearstatcache;
   &tip.fopen-wrapper.stat;
  </refsect1>
diff --git a/reference/filesystem/functions/filemtime.xml b/reference/filesystem/functions/filemtime.xml
index 79e161c054..be7b54f111 100644
--- a/reference/filesystem/functions/filemtime.xml
+++ b/reference/filesystem/functions/filemtime.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
+<!-- $Revision: 1.9 $ -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.filemtime">
  <refnamediv>
   <refname>filemtime</refname>
@@ -66,6 +66,11 @@ if (file_exists($filename)) {
 
  <refsect1 role="notes">
   &reftitle.notes;
+  <note>
+   <para>
+    Note that the time resolution may be different from the file system to another.
+   </para>
+  </note>
   &note.clearstatcache;
   &tip.fopen-wrapper.stat;
  </refsect1>
diff --git a/reference/filesystem/functions/stat.xml b/reference/filesystem/functions/stat.xml
index 257b8f2415..3057a7e893 100644
--- a/reference/filesystem/functions/stat.xml
+++ b/reference/filesystem/functions/stat.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.19 $ -->
+<!-- $Revision: 1.20 $ -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.stat">
  <refnamediv>
   <refname>stat</refname>
@@ -168,6 +168,11 @@
 
  <refsect1 role="notes">
   &reftitle.notes;
+  <note>
+   <para>
+    Note that the time resolution may be different from the file system to another.
+   </para>
+  </note>
   &note.clearstatcache;
   &tip.fopen-wrapper.stat;
  </refsect1>
diff --git a/reference/filesystem/functions/touch.xml b/reference/filesystem/functions/touch.xml
index 80db6ef47b..db07b4c86e 100644
--- a/reference/filesystem/functions/touch.xml
+++ b/reference/filesystem/functions/touch.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.15 $ -->
+<!-- $Revision: 1.16 $ -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.touch">
  <refnamediv>
   <refname>touch</refname>
@@ -114,6 +114,11 @@ if (touch($FileName)) {
 
  <refsect1 role="notes">
   &reftitle.notes;
+  <note>
+   <para>
+    Note that the time resolution may be different from the file system to another.
+   </para>
+  </note>
   <warning>
    <para>
     Prior to PHP 5.3.0 it was not possible to change the modification time