Updating docblocks; adding missing options.

console/Command.php

@@ -378,14 +378,14 @@ public function stop($status = 0, $message = null) {
 	/**
 	 * Handles the response that is sent to the stream.
 	 *
-	 * @param string $type the stream either output or error
-	 * @param string $string the message to render
-	 * @param integer|string|array $options
-	 *        integer as the number of new lines.
-	 *        string as the style
-	 *        array as :
-	 *        - nl : number of new lines to add at the end
-	 *        - style : the style name to wrap around the
+	 * @param string $type The stream either output or error.
+	 * @param string $string The message to render.
+	 * @param integer|string|array $options When passed an integer is used as the number
+	 *                             of new lines, when passed a string it is interpreted as
+	 *                             style to use otherwise when an array following options are
+	 *                             available:
+	 *                             - `'nl'` _integer_: number of new lines to add at the end.
+	 *                             - `'style'` _string_: the style name to wrap around the.
 	 * @return void
 	 */
 	protected function _response($type, $string, $options) {

console/command/Library.php

@@ -288,6 +288,7 @@ protected function _findReplacements($base = null) {
 	 *
 	 * @param string $extracted contains the path to the extracted archive.
 	 * @param array $options Valid options are:
+	 *        - `'namespace'`: Namespace used for extracted libraries.
 	 *        - `'replacements'`: an array of string replacements indexed by filename.
 	 *          It's also possible to use glob-style wildcards in the filename such
 	 *          as `*` or `*.php` or `resources/g11n/*`.  If the filename starts

data/source/Database.php

@@ -1570,12 +1570,12 @@ protected function _on(array $constraints, $aliasFrom, $aliasTo, $mapAlias = arr
 	}
 
 	/**
-	 * Build a SQL column/table meta
+	 * Build a SQL column/table meta.
 	 *
-	 * @param string $type The type of the meta to build (possible values: 'table' or 'column')
-	 * @param string $name The name of the meta to build
-	 * @param mixed $value The value used for building the meta
-	 * @return string The SQL meta string
+	 * @param string $type The type of the meta to build (possible values: `'table'` or `'column'`).
+	 * @param string $name The name of the meta to build.
+	 * @param mixed $value The value used for building the meta.
+	 * @return string The SQL meta string.
 	 */
 	protected function _meta($type, $name, $value) {
 		$meta = isset($this->_metas[$type][$name]) ? $this->_metas[$type][$name] : null;

data/source/database/adapter/MySql.php

@@ -400,10 +400,11 @@ protected function _column($real) {
 	}
 
 	/**
-	 * Helper for `DatabaseSchema::_column()`
+	 * Helper for `Database::column()`
 	 *
-	 * @param array $field A field array
-	 * @return string The SQL column string
+	 * @see lithium\data\Database::column()
+	 * @param array $field A field array.
+	 * @return string The SQL column string.
 	 */
 	protected function _buildColumn($field) {
 		extract($field);

data/source/database/adapter/PostgreSql.php

@@ -488,10 +488,11 @@ protected function _formatters() {
 	}
 
 	/**
-	 * Helper for `DatabaseSchema::_column()`
+	 * Helper for `Database::column()`.
 	 *
-	 * @param array $field A field array
-	 * @return string SQL column string
+	 * @see lithium\data\Database::column()
+	 * @param array $field A field array.
+	 * @return string SQL column string.
 	 */
 	protected function _buildColumn($field) {
 		extract($field);

data/source/database/adapter/Sqlite3.php

@@ -356,10 +356,11 @@ protected function _column($real) {
 	}
 
 	/**
-	 * Helper for `DatabaseSchema::_column()`
+	 * Helper for `Database::column()`.
 	 *
-	 * @param array $field A field array
-	 * @return string SQL column string
+	 * @see lithium\data\Database::column()
+	 * @param array $field A field array.
+	 * @return string SQL column string.
 	 */
 	protected function _buildColumn($field) {
 		extract($field);