Adding and correcting doc blocks.

cake/libs/cake_socket.php

@@ -87,6 +87,7 @@ class CakeSocket extends Object {
  * Constructor.
  *
  * @param array $config Socket configuration, which will be merged with the base configuration
+ * @see CakeSocket::$_baseConfig
  */
 	function __construct($config = array()) {
 		parent::__construct();
@@ -181,7 +182,7 @@ class CakeSocket extends Object {
  */
 	function lastError() {
 		if (!empty($this->lastError)) {
-			return $this->lastError['num'].': '.$this->lastError['str'];
+			return $this->lastError['num'] . ': ' . $this->lastError['str'];
 		} else {
 			return null;
 		}

cake/libs/string.php

@@ -260,17 +260,17 @@ class String {
 	}
 
 /**
- * Cleans up a Set::insert formated string with given $options depending on the 'clean' key in
+ * Cleans up a String::insert() formated string with given $options depending on the 'clean' key in
  * $options. The default method used is text but html is also available. The goal of this function
  * is to replace all whitespace and uneeded markup around placeholders that did not get replaced
- * by Set::insert.
+ * by String::insert().
  *
  * @param string $str
  * @param string $options
  * @return string
  * @access public
  * @static
- * @see Set::insert()
+ * @see String::insert()
  */
 	function cleanInsert($str, $options) {
 		$clean = $options['clean'];

cake/libs/view/helper.php

@@ -191,7 +191,7 @@ class Helper extends Overloadable {
  * Checks if a file exists when theme is used, if no file is found default location is returned
  *
  * @param string $file The file to create a webroot path to.
- * @return string $webPath web path to file.
+ * @return string Web accessible path to file.
  * @access public
  */
 	function webroot($file) {
@@ -250,9 +250,11 @@ class Helper extends Overloadable {
 	}
 
 /**
- * Used to remove harmful tags from content
+ * Used to remove harmful tags from content.  Removes a number of well known XSS attacks
+ * from content.  However, is not guaranteed to remove all possiblities.  Escaping
+ * content is the best way to prevent all possible attacks.
  *
- * @param mixed $output
+ * @param mixed $output Either an array of strings to clean or a single string to clean.
  * @return cleaned content for output
  * @access public
  */

cake/libs/view/view.php

@@ -448,7 +448,7 @@ class View extends Object {
  * Renders a layout. Returns output from _render(). Returns false on error.
  * Several variables are created for use in layout.
  *
- * - `title_for_layout` - contains page title
+ * - `title_for_layout` - A backwards compatible place holder, you should set this value if you want more control.
  * - `content_for_layout` - contains rendered view file
  * - `scripts_for_layout` - contains scripts added to header
  *