From 6777ff863a1b68bb4cb4c81fff97eb44c5a4bfe3 Mon Sep 17 00:00:00 2001
From: Sara Golemon <pollita@php.net>
Date: Sat, 29 Nov 2003 16:39:55 +0000
Subject: [PATCH] Add tip introducing url_stat() support

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@145140 c90b9560-bf6c-de11-be94-00142212c4b1
---
 language-snippets.ent                            | 6 ++++++
 reference/filesystem/functions/file-exists.xml   | 6 +++---
 reference/filesystem/functions/fileatime.xml     | 4 ++--
 reference/filesystem/functions/filectime.xml     | 4 ++--
 reference/filesystem/functions/filegroup.xml     | 4 ++--
 reference/filesystem/functions/fileinode.xml     | 4 ++--
 reference/filesystem/functions/filemtime.xml     | 4 ++--
 reference/filesystem/functions/fileowner.xml     | 4 ++--
 reference/filesystem/functions/fileperms.xml     | 4 ++--
 reference/filesystem/functions/filesize.xml      | 4 ++--
 reference/filesystem/functions/filetype.xml      | 4 ++--
 reference/filesystem/functions/is-dir.xml        | 4 ++--
 reference/filesystem/functions/is-executable.xml | 4 ++--
 reference/filesystem/functions/is-file.xml       | 4 ++--
 reference/filesystem/functions/is-link.xml       | 6 +++---
 reference/filesystem/functions/is-readable.xml   | 4 ++--
 reference/filesystem/functions/is-writable.xml   | 4 ++--
 reference/filesystem/functions/lstat.xml         | 4 ++--
 reference/filesystem/functions/stat.xml          | 6 +++---
 19 files changed, 45 insertions(+), 39 deletions(-)

diff --git a/language-snippets.ent b/language-snippets.ent
index eabf10bef7..ec7eb261cd 100644
--- a/language-snippets.ent
+++ b/language-snippets.ent
@@ -39,6 +39,12 @@ See <function>fopen</function> for more details on how to specify
 the filename and <xref linkend="wrappers"/> for a list of supported
 URL protocols.</simpara></tip>'>
 
+<!ENTITY tip.fopen-wrapper.stat '<tip><simpara>As of 
+<literal>PHP 5.0.0</literal> this function can also be used with 
+<emphasis>some</emphasis> url wrappers.  Refer to 
+<xref linkend="wrappers"/> for a listing of which wrappers support 
+<function>stat</function> family of functionality.</simpara></tip>'>
+
 <!ENTITY return.success 'Returns &true; on success or &false; on failure.'>
 
 <!ENTITY array.resetspointer '<note><simpara>This function will 
diff --git a/reference/filesystem/functions/file-exists.xml b/reference/filesystem/functions/file-exists.xml
index 76926a09c6..54ee735251 100644
--- a/reference/filesystem/functions/file-exists.xml
+++ b/reference/filesystem/functions/file-exists.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.10 $ -->
+<!-- $Revision: 1.11 $ -->
 <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
   <refentry id="function.file-exists">
    <refnamediv>
@@ -41,8 +41,8 @@ if (file_exists($filename)) {
     </para>
 
     &note.clearstatcache;
-    
-    &note.no-remote;
+
+    &tip.fopen-wrapper.stat;
 
     <para>
      See also <function>is_readable</function>, <function>is_writable</function>,
diff --git a/reference/filesystem/functions/fileatime.xml b/reference/filesystem/functions/fileatime.xml
index 6b39414ff0..f7fcf9aaa6 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.4 $ -->
+<!-- $Revision: 1.5 $ -->
 <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
   <refentry id="function.fileatime">
    <refnamediv>
@@ -29,7 +29,7 @@
     
     &note.clearstatcache;
     
-    &note.no-remote;
+    &tip.fopen-wrapper.stat;
 
     <para>
      <example>
diff --git a/reference/filesystem/functions/filectime.xml b/reference/filesystem/functions/filectime.xml
index 17cf3e1641..d0b568cbc8 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.4 $ -->
+<!-- $Revision: 1.5 $ -->
 <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
   <refentry id="function.filectime">
    <refnamediv>
@@ -32,7 +32,7 @@
     
     &note.clearstatcache;
     
-    &note.no-remote;
+    &tip.fopen-wrapper.stat;
 
     <para>
      <example>
diff --git a/reference/filesystem/functions/filegroup.xml b/reference/filesystem/functions/filegroup.xml
index 49b20e589e..e0824f14a4 100644
--- a/reference/filesystem/functions/filegroup.xml
+++ b/reference/filesystem/functions/filegroup.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
   <refentry id="function.filegroup">
    <refnamediv>
@@ -22,7 +22,7 @@
     
     &note.clearstatcache;
     
-    &note.no-remote;
+    &tip.fopen-wrapper.stat;
     
     <simpara>
      See also <function>fileowner</function>, and
diff --git a/reference/filesystem/functions/fileinode.xml b/reference/filesystem/functions/fileinode.xml
index 307c3cd9da..bd57624898 100644
--- a/reference/filesystem/functions/fileinode.xml
+++ b/reference/filesystem/functions/fileinode.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
 <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
   <refentry id="function.fileinode">
    <refnamediv>
@@ -19,7 +19,7 @@
     
     &note.clearstatcache;
     
-    &note.no-remote;
+    &tip.fopen-wrapper.stat;
     
     <simpara>
      See also <function>stat</function>
diff --git a/reference/filesystem/functions/filemtime.xml b/reference/filesystem/functions/filemtime.xml
index 95f1c263d8..7c5fe381c9 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.4 $ -->
+<!-- $Revision: 1.5 $ -->
 <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
   <refentry id="function.filemtime">
    <refnamediv>
@@ -20,7 +20,7 @@
     
     &note.clearstatcache;
     
-    &note.no-remote;
+    &tip.fopen-wrapper.stat;
 
     <para>
      This function returns the time when the data
diff --git a/reference/filesystem/functions/fileowner.xml b/reference/filesystem/functions/fileowner.xml
index 0c123eff72..e9ccce4093 100644
--- a/reference/filesystem/functions/fileowner.xml
+++ b/reference/filesystem/functions/fileowner.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
 <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
   <refentry id="function.fileowner">
    <refnamediv>
@@ -20,7 +20,7 @@
     
     &note.clearstatcache;
     
-    &note.no-remote;
+    &tip.fopen-wrapper.stat;
     
     <simpara>
      See also <function>stat</function>
diff --git a/reference/filesystem/functions/fileperms.xml b/reference/filesystem/functions/fileperms.xml
index e3faa2d3f5..4e5d3b2013 100644
--- a/reference/filesystem/functions/fileperms.xml
+++ b/reference/filesystem/functions/fileperms.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
 <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
   <refentry id="function.fileperms">
    <refnamediv>
@@ -18,7 +18,7 @@
     
     &note.clearstatcache;
     
-    &note.no-remote;
+    &tip.fopen-wrapper.stat;
     
     <simpara>
      See also <function>is_readable</function>,
diff --git a/reference/filesystem/functions/filesize.xml b/reference/filesystem/functions/filesize.xml
index ef8f066da4..7e6a5fbd0d 100644
--- a/reference/filesystem/functions/filesize.xml
+++ b/reference/filesystem/functions/filesize.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
   <refentry id="function.filesize">
    <refnamediv>
@@ -26,7 +26,7 @@
     
     &note.clearstatcache;
 
-    &note.no-remote;
+    &tip.fopen-wrapper.stat;
 
     <para>
      <example>
diff --git a/reference/filesystem/functions/filetype.xml b/reference/filesystem/functions/filetype.xml
index 5051ce2bdd..501ad8d401 100644
--- a/reference/filesystem/functions/filetype.xml
+++ b/reference/filesystem/functions/filetype.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.9 $ -->
+<!-- $Revision: 1.10 $ -->
 <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
   <refentry id="function.filetype">
    <refnamediv>
@@ -24,7 +24,7 @@
     
     &note.clearstatcache;
     
-    &note.no-remote;
+    &tip.fopen-wrapper.stat;
 
     <para>
      <example>
diff --git a/reference/filesystem/functions/is-dir.xml b/reference/filesystem/functions/is-dir.xml
index 6affe91db0..e5d5005382 100644
--- a/reference/filesystem/functions/is-dir.xml
+++ b/reference/filesystem/functions/is-dir.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.7 $ -->
+<!-- $Revision: 1.8 $ -->
 <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
   <refentry id="function.is-dir">
    <refnamediv>
@@ -20,7 +20,7 @@
 
     &note.clearstatcache;
     
-    &note.no-remote;
+    &tip.fopen-wrapper.stat;
 
     <para>
      See also <function>chdir</function>, <link linkend="class.dir">dir</link>,
diff --git a/reference/filesystem/functions/is-executable.xml b/reference/filesystem/functions/is-executable.xml
index 689b547076..cd8e29501a 100644
--- a/reference/filesystem/functions/is-executable.xml
+++ b/reference/filesystem/functions/is-executable.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
+<!-- $Revision: 1.9 $ -->
 <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
   <refentry id="function.is-executable">
    <refnamediv>
@@ -42,7 +42,7 @@ if(is_executable($file)) {
     
     &note.clearstatcache;
 
-    &note.no-remote;
+	&tip.fopen-wrapper.stat;
 
     <para>
      See also <function>is_file</function> and
diff --git a/reference/filesystem/functions/is-file.xml b/reference/filesystem/functions/is-file.xml
index 233961bc20..41cd2211fa 100644
--- a/reference/filesystem/functions/is-file.xml
+++ b/reference/filesystem/functions/is-file.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
   <refentry id="function.is-file">
    <refnamediv>
@@ -18,7 +18,7 @@
 
     &note.clearstatcache;
     
-    &note.no-remote;
+    &tip.fopen-wrapper.stat;
 
     <para>
      See also <function>is_dir</function> and
diff --git a/reference/filesystem/functions/is-link.xml b/reference/filesystem/functions/is-link.xml
index 68634b08af..8941ac346d 100644
--- a/reference/filesystem/functions/is-link.xml
+++ b/reference/filesystem/functions/is-link.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
   <refentry id="function.is-link">
    <refnamediv>
@@ -17,8 +17,8 @@
     </para>
     
     &note.clearstatcache;
-    
-    &note.no-remote;
+
+    &tip.fopen-wrapper.stat;
     
     <para>
      See also <function>is_dir</function>,
diff --git a/reference/filesystem/functions/is-readable.xml b/reference/filesystem/functions/is-readable.xml
index fb5501c733..c646f54129 100644
--- a/reference/filesystem/functions/is-readable.xml
+++ b/reference/filesystem/functions/is-readable.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
 <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
   <refentry id="function.is-readable">
    <refnamediv>
@@ -23,7 +23,7 @@
 
     &note.clearstatcache;
 
-    &note.no-remote;
+    &tip.fopen-wrapper.stat;
 
     <para>
      See also <function>is_writable</function>, 
diff --git a/reference/filesystem/functions/is-writable.xml b/reference/filesystem/functions/is-writable.xml
index efc1599d95..6117ea66d1 100644
--- a/reference/filesystem/functions/is-writable.xml
+++ b/reference/filesystem/functions/is-writable.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
   <refentry id="function.is-writable">
    <refnamediv>
@@ -25,7 +25,7 @@
 
     &note.clearstatcache;
     
-    &note.no-remote;
+    &tip.fopen-wrapper.stat;
     
     <para>
      See also <function>is_readable</function>,
diff --git a/reference/filesystem/functions/lstat.xml b/reference/filesystem/functions/lstat.xml
index f15b89d994..8795116107 100644
--- a/reference/filesystem/functions/lstat.xml
+++ b/reference/filesystem/functions/lstat.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
   <refentry id="function.lstat">
    <refnamediv>
@@ -27,7 +27,7 @@
 
     &note.clearstatcache;
     
-    &note.no-remote;
+    &tip.fopen-wrapper.stat;
     
     <simpara>
      See also <function>stat</function>.
diff --git a/reference/filesystem/functions/stat.xml b/reference/filesystem/functions/stat.xml
index 71989f3124..afe73bea11 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.8 $ -->
+<!-- $Revision: 1.9 $ -->
 <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
   <refentry id="function.stat">
    <refnamediv>
@@ -119,8 +119,8 @@
     </para>
     
     &note.clearstatcache;
-    
-    &note.no-remote;
+
+    &tip.fopen-wrapper.stat;
     
     <para>
      See also <function>lstat</function>,