From 232bf9c194c47475132cd0323bde767519ad8f03 Mon Sep 17 00:00:00 2001
From: Andrei Zmievski <andrei@php.net>
Date: Tue, 11 Jul 2000 20:06:21 +0000
Subject: [PATCH] Docs for realpath().

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@28144 c90b9560-bf6c-de11-be94-00142212c4b1
---
 functions/filesystem.xml | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/functions/filesystem.xml b/functions/filesystem.xml
index 7c0bb2070e..d0944e2e87 100644
--- a/functions/filesystem.xml
+++ b/functions/filesystem.xml
@@ -2029,6 +2029,38 @@ $fp = popen ("/bin/ls", "r");
    </refsect1>
   </refentry>
 
+  <refentry id="function.realpath">
+   <refnamediv>
+    <refname>realpath</refname>
+    <refpurpose>Return canonicalized absolute pathname</refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+    <funcsynopsis>
+     <funcprototype>
+      <funcdef>string <function>realpath</function></funcdef>
+      <paramdef>string <parameter>path</parameter></paramdef>
+     </funcprototype>
+    </funcsynopsis>
+    <para>
+     <function>realpath</function> expands all symbolic links and
+     resolves references to '/./', '/../' and extra '/' characters in
+     the input <parameter>path</parameter> and return the canonicalized
+     absolute pathname.  The resulting path will have no symbolic link,
+     '/./' or '/../' components.
+    </para>
+
+    <para>
+     <example>
+      <title><function>realpath</function> example</title>
+      <programlisting role="php">
+$real_path = realpath("../../index.php");
+      </programlisting>
+     </example>
+    </para>
+   </refsect1>
+  </refentry>
+
   <refentry id="function.symlink">
    <refnamediv>
     <refname>symlink</refname>