[Oorexx-svn] SF.net SVN: oorexx:[6347] docs/trunk/rexxref/utilityclasses.xml

[<jfa...@us...>]

Revision: 6347
          http://oorexx.svn.sourceforge.net/oorexx/?rev=6347&view=rev
Author:   jfaucher
Date:     2010-11-02 23:43:38 +0000 (Tue, 02 Nov 2010)

Log Message:
-----------
Doc of File class : work in progress, 11 methods remaining to document.

Modified Paths:
--------------
    docs/trunk/rexxref/utilityclasses.xml

Modified: docs/trunk/rexxref/utilityclasses.xml
===================================================================
--- docs/trunk/rexxref/utilityclasses.xml	2010-11-02 19:32:20 UTC (rev 6346)
+++ docs/trunk/rexxref/utilityclasses.xml	2010-11-02 23:43:38 UTC (rev 6347)
@@ -5989,7 +5989,7 @@
 ]]>
 </programlisting>
 
-<para>Returns the fully qualifed path as a new instance of File.
+<para>Returns the fully qualified path as a new instance of File.
 </para>
 <para><emphasis role="bold">Examples:</emphasis></para>
 <programlisting>
@@ -6022,7 +6022,7 @@
 ]]>
 </programlisting>
 
-<para>Returns the fully qualifed path as a string.
+<para>Returns the fully qualified path as a string.
 </para>
 <para><emphasis role="bold">Examples:</emphasis></para>
 <programlisting>
@@ -6296,8 +6296,18 @@
 ]]>
 </programlisting>
 
-<para>todo.
+<para>Returns the last modified date of the file/directory denoted by the absolute
+path of the receiver object. The result is a DateTime object, or .nil in case of error.
 </para>
+<para><emphasis role="bold">Examples:</emphasis></para>
+<programlisting>
+<![CDATA[
+/* On Windows */
+say .File~new("C:\Program Files")~lastModified~class    --> The DateTime class
+say .File~new("C:\Program Files")~lastModified          --> 2010-11-01T19:14:49.000000
+say .File~new("dummy")~lastModified                     --> The NIL object
+]]>
+</programlisting>
 </section>
 
 <section id="mthFileLastModifiedEquals"><title>lastModified=</title>
@@ -6308,12 +6318,28 @@
 <tertiary>of File class</tertiary></indexterm>
 <programlisting>
 <![CDATA[
->>-lastModified=date-------------------------------------------><
+>>-lastModified=(date)-----------------------------------------><
 ]]>
 </programlisting>
 
-<para>todo.
+<para>Sets the last modified date of the file/directory denoted by the absolute path of the receiver object.
 </para>
+<para>The <emphasis role="italic">date</emphasis> parameter is a DateTime object. 
+</para>
+<para><emphasis role="bold">Examples:</emphasis></para>
+<programlisting>
+<![CDATA[
+/* Implementation of : touch -c -f -r referenceFile file */
+parse arg referenceFilePath filePath .
+file = .File~new(filePath)
+if \ file~exists then return 1 -- KO
+referenceFile = .File~new(referenceFilePath)
+referenceDate = referenceFile~lastModified
+if referenceDate == .nil then return 1 -- KO
+file~lastModified = referenceDate
+return 0 -- OK
+]]>
+</programlisting>
 </section>
 
 <section id="mthFileLength"><title>length</title>
@@ -6328,7 +6354,8 @@
 ]]>
 </programlisting>
 
-<para>todo.
+<para>Returns the size in bytes of the file/directory denoted by the absolute
+path of the receiver object.
 </para>
 </section>
 


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.