Index: write-test.php
===================================================================
RCS file: /repository/qaweb/write-test.php,v
retrieving revision 1.12
diff -u -p -d -r1.12 write-test.php
--- write-test.php	9 Dec 2006 22:13:01 -0000	1.12
+++ write-test.php	4 Jun 2007 11:32:01 -0000
@@ -107,6 +107,49 @@ as the body of the .php file, so don't f
 the part used as a comparison to see if the test passes.  It is a
 good idea to generate output with var_dump() calls.</p>
 
+<h3>Cleaning up after writing a test</h3>
+<p>Sometimes test cases create files or directories as part of the test case and it's important to remove these after the test ends, the --CLEAN--
+section is provided to help with this.</p>
+<p> The PHP code in the --CLEAN-- section is executed separately from the code in the --FILE-- section. For example, this code:</p>
+<pre>
+--TEST--
+Will fail to clean up
+--FILE--
+&lt;?php
+      $temp_filename = "fred.tmp";
+      $fp = fopen ($temp_filename, "w");
+      fwrite($fp, "Hello Boys!");
+      fclose($fp);
+?&gt;
+--CLEAN--
+&lt;?php
+      unlink $temp_filename;
+?&gt;
+--EXPECT--
+</pre>
+<p>will not remove the temporary file because the variable $filename is not defined in the --CLEAN-- section.</p>
+<p>Here is a better way to write the code:
+<pre>
+--TEST--
+This will remove temporary files
+--FILE--
+&lt;?php
+	$temp_filename = dirname(__FILE__)."/fred.tmp";
+	$fp = fopen($temp_filename, "w");
+	fwrite ($fp, "Hello Boys!\n");
+	fclose($fp);
+?&gt;
+--CLEAN--
+&lt;?php
+	$temp_filename = dirname(__FILE__)."/fred.tmp";
+	unlink($temp_filename);
+?>
+--EXPECT--
+</pre>
+<p> Note the use of the dirname(__FILE__) construct which will ensure that the temporary file is created in the same directory as
+the phpt test script.
+</p>
+
 <h3>All Sections</h3>
 A phpt test can have many more parts then just the minimum.  In fact some of the mandatory parts have
 alternatives that may be used if the situation warrents it.