From 66095fd370c94bb8b01c366a6e40b1ac3c86a99d Mon Sep 17 00:00:00 2001
From: Ross Masters <ross@php.net>
Date: Thu, 9 Oct 2008 20:40:06 +0000
Subject: [PATCH] Added missing examples.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@267129 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/filesystem/functions/chown.xml   | 51 +++++++++++++++++++++-
 reference/filesystem/functions/is-link.xml | 27 +++++++++++-
 reference/filesystem/functions/lstat.xml   | 39 ++++++++++++++++-
 reference/filesystem/functions/symlink.xml | 22 +++++++++-
 reference/filesystem/functions/unlink.xml  | 25 ++++++++++-
 5 files changed, 159 insertions(+), 5 deletions(-)

diff --git a/reference/filesystem/functions/chown.xml b/reference/filesystem/functions/chown.xml
index f5e089fa8d..2518645ff9 100644
--- a/reference/filesystem/functions/chown.xml
+++ b/reference/filesystem/functions/chown.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.chown">
  <refnamediv>
   <refname>chown</refname>
@@ -51,6 +51,55 @@
   </para>
  </refsect1>
 
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Simple <function>chown</function> usage</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+
+// File name and username to use
+$file_name= "foo.php";
+$path = "/home/sites/php.net/public_html/sandbox" . $file_name ;
+$user_name = "root";
+
+// Set the user
+chown($path, $user_name);
+
+// Check the result
+$stat = stat($path);
+print_r(posix_getpwuid($stat['uid']));
+
+?>
+]]>
+    </programlisting>
+    &example.outputs.similar;
+    <screen>
+<![CDATA[
+array(7) {
+  ["name"]=>
+  string(13) "php.net"
+  ["passwd"]=>
+  string(1) "x"
+  ["uid"]=>
+  int(148864)
+  ["gid"]=>
+  int(148910)
+  ["gecos"]=>
+  string(13) "php.net"
+  ["dir"]=>
+  string(25) "/home/sites/php.net"
+  ["shell"]=>
+  string(13) "/sbin/nologin"
+}
+]]>
+    </screen>
+   </example>
+  </para>
+ </refsect1>
+
  <refsect1 role="notes">
   &reftitle.notes;
   &note.no-remote;
diff --git a/reference/filesystem/functions/is-link.xml b/reference/filesystem/functions/is-link.xml
index ead2af3046..380fb7300c 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.9 $ -->
+<!-- $Revision: 1.10 $ -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.is-link">
  <refnamediv>
   <refname>is_link</refname>
@@ -41,6 +41,31 @@
   </para>
  </refsect1>
 
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Create and confirm if a file is a symbolic link</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$link = 'uploads';
+
+if(is_link($link))
+{
+    echo(readlink($link));
+}
+else
+{
+    symlink('uploads.php', $link);
+}
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+ </refsect1>
+
  <refsect1 role="notes">
   &reftitle.notes;
   &note.clearstatcache;
diff --git a/reference/filesystem/functions/lstat.xml b/reference/filesystem/functions/lstat.xml
index 4ef6758ce3..bac1d1079a 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.9 $ -->
+<!-- $Revision: 1.10 $ -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.lstat">
  <refnamediv>
   <refname>lstat</refname>
@@ -46,6 +46,43 @@
   </para>
  </refsect1>
 
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Comparison of <function>stat</function> and <function>lstat</function></title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+symlink('uploads.php', 'uploads');
+
+// Contrast information for uploads.php and uploads
+array_diff(stat('uploads'), lstat('uploads'));
+?>
+]]>
+    </programlisting>
+    &example.outputs.similar;
+    <para>
+     Information that differs between the two files.
+    </para>
+    <screen>
+<![CDATA[
+Array
+(
+    [ino] => 97236376
+    [mode] => 33188
+    [size] => 34
+    [atime] => 1223580003
+    [mtime] => 1223581848
+    [ctime] => 1223581848
+    [blocks] => 8
+)
+]]>
+    </screen>
+   </example>
+  </para>
+ </refsect1>
+
  <refsect1 role="notes">
   &reftitle.notes;
   &note.clearstatcache;
diff --git a/reference/filesystem/functions/symlink.xml b/reference/filesystem/functions/symlink.xml
index 6bfb32c225..a575289580 100644
--- a/reference/filesystem/functions/symlink.xml
+++ b/reference/filesystem/functions/symlink.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.9 $ -->
+<!-- $Revision: 1.10 $ -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.symlink">
  <refnamediv>
   <refname>symlink</refname>
@@ -51,6 +51,26 @@
   </para>
  </refsect1>
 
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Create a symbolic link</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$target = 'uploads.php';
+$link = 'uploads';
+symlink($target, $link);
+
+echo(readlink($link));
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+ </refsect1>
+
  <refsect1 role="notes">
   &reftitle.notes;
   &note.no-windows;
diff --git a/reference/filesystem/functions/unlink.xml b/reference/filesystem/functions/unlink.xml
index 884a744aeb..1ea580c014 100644
--- a/reference/filesystem/functions/unlink.xml
+++ b/reference/filesystem/functions/unlink.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.12 $ -->
+<!-- $Revision: 1.13 $ -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.unlink">
  <refnamediv>
   <refname>unlink</refname>
@@ -75,6 +75,29 @@
   </para>
  </refsect1>
 
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Basic <function>unlink</function> usage</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$fh = fopen('test.html', 'a');
+fwrite($fh, '<h1>Hello world!</h1>');
+fclose($fh);
+
+mkdir('testdir', 0777);
+
+unlink('test.html');
+unlink('testdir');
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>