From fd3ee665d5dbf1b164715018848ae94831fc7cc3 Mon Sep 17 00:00:00 2001
From: Brett Bieber <saltybeagle@php.net>
Date: Fri, 14 Nov 2008 19:51:08 +0000
Subject: [PATCH] Document SplFileInfo::getCTime()

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@269018 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/spl/splfileinfo/getctime.xml | 22 +++++++++++++++-------
 1 file changed, 15 insertions(+), 7 deletions(-)

diff --git a/reference/spl/splfileinfo/getctime.xml b/reference/spl/splfileinfo/getctime.xml
index 6cb9028a77..ab5037eacd 100644
--- a/reference/spl/splfileinfo/getctime.xml
+++ b/reference/spl/splfileinfo/getctime.xml
@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
 
 <refentry xml:id="splfileinfo.getctime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>SplFileInfo::getCTime</refname>
-  <refpurpose>The getCTime purpose</refpurpose>
+  <refpurpose>Gets the last change time</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -14,7 +14,7 @@
    <void />
   </methodsynopsis>
   <para>
-   The method description goes here.
+   Returns the time the file was last changed. The time returned is a UNIX timestamp.
   </para>
  </refsect1>
 
@@ -26,7 +26,14 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Description...
+   The last change time, in a UNIX timestamp.
+  </para>
+ </refsect1>
+
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <para>
+   Throws <methodname>RunTimeException</methodname> on error.
   </para>
  </refsect1>
 
@@ -38,14 +45,15 @@
     <programlisting role="php">
 <![CDATA[
 <?php
-/* ... */
+$info = new SplFileInfo(__FILE__);
+echo 'Last changed at ' . date('g:i a', $info->getCTime());
 ?>
 ]]>
     </programlisting>
     &example.outputs.similar;
     <screen>
 <![CDATA[
-...
+Last changed at 1:49 pm
 ]]>
     </screen>
    </example>
@@ -56,7 +64,7 @@
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><methodname>Classname::Method</methodname></member>
+    <member><function>filectime</function></member>
    </simplelist>
   </para>
  </refsect1>