OpenBuildings / jam

classes/Kohana/Jam/Meta.php

Doc Comments +6 added lines, -4 removed lines

@@ -261,6 +261,9 @@ 
 		return $this->_collection;
 	}
 
+	/**
+	 * @param string $field
+	 */
 	public function validator($field, $options)
 	{
 		$fields = func_get_args();
@@ -403,7 +406,7 @@ 
 	 *
 	 * @param   string       $name     name of the field
 	 * @param   mixed        $field    the field alias or object
-	 * @return  Jam_Field|Jam_Meta|null
+	 * @return  string
 	 */
 	public function field($name, $field = NULL, $prepend = FALSE)
 	{
@@ -629,7 +632,6 @@ 
 	 * Get / Set individual behaviors.
 	 *
 	 * @param   string       $name     name of the association
-	 * @param   mixed        $association    the association alias or object
 	 * @return  Jam_Association|Jam_Meta|null
 	 */
 	public function behavior($name, $behavior = NULL, $prepend = FALSE)
@@ -666,7 +668,7 @@ 
 	/**
 	 * Gets the events attached to the object.
 	 *
-	 * @return  array|Jam_Event
+	 * @return  Jam_Event
 	 */
 	public function events()
 	{
@@ -677,7 +679,7 @@ 
 	 * Gets or sets the model's primary key.
 	 *
 	 * @param   string  $value
-	 * @return  mixed
+	 * @return  string
 	 */
 	public function primary_key($value = NULL)
 	{

classes/Kohana/Jam/Model.php

Doc Comments +4 added lines, -3 removed lines

@@ -39,7 +39,6 @@ 
 	 * A key can be passed to automatically load a model by its
 	 * unique key.
 	 *
-	 * @param  mixed|null  $key
 	 */
 	public function __construct($meta_name = NULL)
 	{
@@ -190,8 +189,7 @@ 
 	 * Validates the current model's data
 	 *
 	 * @throws  Jam_Exception_Validation
-	 * @param   Validation|null   $extra_validation
-	 * @return  Kohana_Jam_Model
+	 * @return  boolean
 	 */
 	public function check($force = FALSE)
 	{
@@ -436,6 +434,9 @@ 
 		return $attribute;
 	}
 
+	/**
+	 * @param string $association_name
+	 */
 	public function build($association_name, array $attributes = array())
 	{
 		$association = $this->meta()->association($association_name);

classes/Kohana/Jam/Query/Builder/Collection.php

Doc Comments +1 added lines

@@ -89,6 +89,7 @@
 	 *
 	 * @param   string  column for associative keys
 	 * @param   string  column for values
+	 * @param string $value
 	 * @return  array
 	 */
 	public function as_array($key = NULL, $value = NULL)

classes/Kohana/Jam/Query/Builder/Delete.php

Doc Comments +1 added lines, -1 removed lines

@@ -41,7 +41,7 @@
 	 *
 	 * @throws  Kohana_Exception
 	 * @param   string|null  $model
-	 * @param   mixed|null   $key
+	 * @param   string|null   $key
 	 */
 	public function __construct($model, $key = NULL)
 	{

classes/Kohana/Jam/Query/Builder/Join.php

Doc Comments +3 added lines

@@ -98,6 +98,9 @@
 		return $compiled;
 	}
 
+	/**
+	 * @param string $context_model
+	 */
 	public function context_model($context_model = NULL)
 	{
 		if ($context_model !== NULL)

classes/Kohana/Jam/Query/Builder/Select.php

Doc Comments +11 added lines, -1 removed lines

@@ -42,7 +42,6 @@ 
 	 *
 	 * @throws  Kohana_Exception
 	 * @param   string|null  $model
-	 * @param   mixed|null   $key
 	 */
 	public function __construct($model)
 	{
@@ -140,6 +139,11 @@ 
 		return $this;
 	}
 
+	/**
+	 * @param string $c1
+	 * @param string $op
+	 * @param string $c2
+	 */
 	public function on($c1, $op, $c2)
 	{
 		if ( ! $this->_last_join)
@@ -154,6 +158,9 @@ 
 		return $this->_join($association, $type)->end($this);
 	}
 
+	/**
+	 * @param string $table
+	 */
 	public function join_table($table, $type = NULL)
 	{
 		return $this->_join($table, $type, FALSE)->end($this);
@@ -308,6 +315,9 @@ 
 		}
 	}
 
+	/**
+	 * @param string $name
+	 */
 	public function except($name)
 	{
 		$except = func_get_args();

classes/Kohana/Jam/Timezone.php

Doc Comments +6 added lines

@@ -37,6 +37,9 @@ 
 	protected $_master_timezone = NULL;
 	protected $_default_timezone = NULL;
 
+	/**
+	 * @return DateTimeZone
+	 */
 	public function master_timezone($timezone = NULL)
 	{
 		if ($timezone !== NULL)
@@ -53,6 +56,9 @@ 
 		return $this->_master_timezone;
 	}
 
+	/**
+	 * @return DateTimeZone
+	 */
 	public function default_timezone($timezone = NULL)
 	{
 		if ($timezone !== NULL)

classes/Kohana/Jam/Validated.php

Doc Comments +2 added lines, -6 removed lines

@@ -54,7 +54,6 @@ 
 	 * A key can be passed to automatically load a model by its
 	 * unique key.
 	 *
-	 * @param  mixed|null  $key
 	 */
 	public function __construct($meta_name = NULL)
 	{
@@ -114,7 +113,7 @@ 
 	 *
 	 * @param   string  $method
 	 * @param   array   $args
-	 * @return  mixed
+	 * @return  string|null
 	 **/
 	public function __call($method, $args)
 	{
@@ -204,7 +203,6 @@ 
 	 * This method—combined with get(), which first searches for changed
 	 * values—is useful for comparing changes that occurred on a model.
 	 *
-	 * @param   string  $field The field's or alias name
 	 * @return  mixed
 	 */
 	public function original($field_name = NULL)
@@ -321,8 +319,7 @@ 
 	 * Validates the current model's data
 	 *
 	 * @throws  Jam_Exception_Validation
-	 * @param   Validation|null   $extra_validation
-	 * @return  Kohana_Jam_Model
+	 * @return  boolean
 	 */
 	public function check($force = FALSE)
 	{
@@ -437,7 +434,6 @@ 
 	 * If $field is NULL, the method returns whether or not any
 	 * data whatsoever was changed on the model.
 	 *
-	 * @param   string   $field
 	 * @return  boolean
 	 */
 	public function changed($name = NULL)

classes/Kohana/Jam/Validator/Attributes.php

Doc Comments -1 removed lines

@@ -47,7 +47,6 @@
 	protected $_permit = array();
 
 	/**
-	 * @param  array  $data
 	 */
 	public function __construct($permit)
 	{