going thru trunk and cleaning up the file headers so API docs can be created properly

git-svn-id: https://svn.cakephp.org/repo/trunk/cake@311 3807eeeb-6ff5-0310-8944-8be069107fe0

app/app_controller.php

@@ -8,6 +8,16 @@
 // + Licensed under The MIT License                                   + //
 //////////////////////////////////////////////////////////////////////////
 
+/**
+ *
+ * @filesource 
+ * @package cake
+ * @subpackage cake.app
+ * @version $Revision:$
+ * @modifiedby $LastChangedBy:$
+ * @lastmodified $Date:$
+ */
+
 /**
  * This file is application-wide controller file. You can put all 
  * application-wide controller-related methods here.

app/app_model.php

@@ -8,6 +8,16 @@
 // + Licensed under The MIT License                                   + //
 //////////////////////////////////////////////////////////////////////////
 
+/**
+ *
+ * @filesource 
+ * @package cake
+ * @subpackage cake.app
+ * @version $Revision:$
+ * @modifiedby $LastChangedBy:$
+ * @lastmodified $Date:$
+ */
+
 /**
  * This file is application-wide model file. You can put all 
  * application-wide model-related methods here.

app/controllers/pages_controller.php

@@ -8,23 +8,54 @@
 // + Licensed under The MIT License                                   + //
 //////////////////////////////////////////////////////////////////////////
 
-class PagesController extends PagesHelper
+
-{
+/**
+ *
+ * @filesource 
+ * @package cake
+ * @subpackage cake.app.controllers
+ * @version $Revision:$
+ * @modifiedby $LastChangedBy:$
+ * @lastmodified $Date:$
+ */
+
+/**
+ * This file is application-wide controller file. You can put all 
+ * application-wide controller-related methods here.
+ *
+ * Add your application-wide methods in the class below, your controllers 
+ * will inherit them.
+ * 
+ * @package cake
+ * @subpackage cake.app.controllers
+ */
+class PagesController extends PagesHelper{
+   
+/**
+ * Enter description here...
+ *
+ * @var unknown_type
+*/
 	var $helpers = array('html', 'ajax');
-	/**
+	
-	 * Displays a view
+
-	 *
+/**
-	 * @package cake
+ * Displays a view
-	 * @subpackage cake.app
+ *
-	 */
+ */
 	function display()
 	{
 		if (!func_num_args())
+		{
 			$this->redirect('/');
+		}
 
 		$path = func_get_args();
+		
 		if (!count($path))
+		{
 			$this->redirect('/');
+		}
 
 		$this->set('page', $path[0]);
 		$this->set('subpage', empty($path[1])? null: $path[1]);

app/controllers/tests_controller.php

@@ -8,13 +8,26 @@
 // + Licensed under The MIT License                                   + //
 //////////////////////////////////////////////////////////////////////////
 
+/**
+ *
+ * @filesource 
+ * @package cake
+ * @subpackage cake.app.controllers
+ * @version $Revision:$
+ * @modifiedby $LastChangedBy:$
+ * @lastmodified $Date:$
+ */
+
+/**
+ * 
+ * @package cake
+ * @subpackage cake.app.controllers
+ */
 class TestsController extends TestsHelper {
 
 /**
  * Runs all library and application tests
  *
- * @package cake
- * @subpackage cake.app
  */
 	function test_all () 
 	{

app/helpers/pages_helper.php

@@ -8,11 +8,21 @@
 // + Licensed under The MIT License                                   + //
 //////////////////////////////////////////////////////////////////////////
 
+/**
+ *
+ * @filesource 
+ * @package cake
+ * @subpackage cake.app.helpers
+ * @version $Revision:$
+ * @modifiedby $LastChangedBy:$
+ * @lastmodified $Date:$
+ */
+
 /**
  * In this file you can extend the PagesController.
  *
  * @package cake
- * @subpackage cake.app
+ * @subpackage cake.app.helpers
  */
 
 class PagesHelper extends AppController 

app/helpers/tests_helper.php

@@ -8,11 +8,21 @@
 // + Licensed under The MIT License                                   + //
 //////////////////////////////////////////////////////////////////////////
 
+/**
+ *
+ * @filesource 
+ * @package cake
+ * @subpackage cake.app.helpers
+ * @version $Revision:$
+ * @modifiedby $LastChangedBy:$
+ * @lastmodified $Date:$
+ */
+
 /**
  * In this file you can extend the TestsController.
  *
  * @package cake
- * @subpackage cake.app
+ * @subpackage cake.app.helpers
  */
 
 class TestsHelper extends AppController

public/css.php

@@ -54,12 +54,12 @@ function make_clean_css ($path, $name)
 }
 
 /**
-	 * Enter description here...
+ * Enter description here...
-	 *
+ *
-	 * @param unknown_type $path
+ * @param unknown_type $path
-	 * @param unknown_type $content
+ * @param unknown_type $content
-	 * @return unknown
+ * @return unknown
-	 */
+ */
 function write_css_cache ($path, $content)
 {
 	if (!is_dir(dirname($path)))