From 20660a3531d1bfe9b8c0c53207c243fe1ff663b5 Mon Sep 17 00:00:00 2001
From: Jose Lorenzo Rodriguez <jose.zap@gmail.com>
Date: Sun, 17 Mar 2013 14:49:54 +0100
Subject: [PATCH] Adding doc blocks to test case

---
 .../Database/FunctionsTraitTest.php           | 50 +++++++++++++++++++
 1 file changed, 50 insertions(+)

diff --git a/lib/Cake/Test/TestCase/Model/Datasource/Database/FunctionsTraitTest.php b/lib/Cake/Test/TestCase/Model/Datasource/Database/FunctionsTraitTest.php
index 1c2955c0101..96f60f76e76 100644
--- a/lib/Cake/Test/TestCase/Model/Datasource/Database/FunctionsTraitTest.php
+++ b/lib/Cake/Test/TestCase/Model/Datasource/Database/FunctionsTraitTest.php
@@ -25,6 +25,11 @@
  **/
 class FunctionsTraitTest extends \Cake\TestSuite\TestCase {
 
+/**
+ * Setups a mock for FunctionsTrait
+ *
+ * @return void
+ */
 	public function setUp() {
 		parent::setUp();
 		$this->functions = $this->getObjectForTrait(
@@ -32,6 +37,11 @@ public function setUp() {
 		);
 	}
 
+/**
+ * Tests generating a generic function call
+ *
+ * @return void
+ */
 	public function testFunc() {
 		$function = $this->functions->func('MyFunc', ['b' => 'literal']);
 		$this->assertInstanceOf('\Cake\Model\Datasource\Database\Expression\FunctionExpression', $function);
@@ -39,36 +49,66 @@ public function testFunc() {
 		$this->assertEquals('MyFunc(b)', (string)$function);
 	}
 
+/**
+ * Tests generating a SUM() function
+ *
+ * @return void
+ */
 	public function testSum() {
 		$function = $this->functions->sum('total');
 		$this->assertInstanceOf('\Cake\Model\Datasource\Database\Expression\FunctionExpression', $function);
 		$this->assertEquals('SUM(total)', (string)$function);
 	}
 
+/**
+ * Tests generating a AVG() function
+ *
+ * @return void
+ */
 	public function testAvg() {
 		$function = $this->functions->avg('salary');
 		$this->assertInstanceOf('\Cake\Model\Datasource\Database\Expression\FunctionExpression', $function);
 		$this->assertEquals('AVG(salary)', (string)$function);
 	}
 
+/**
+ * Tests generating a MAX() function
+ *
+ * @return void
+ */
 	public function testMAX() {
 		$function = $this->functions->max('created');
 		$this->assertInstanceOf('\Cake\Model\Datasource\Database\Expression\FunctionExpression', $function);
 		$this->assertEquals('MAX(created)', (string)$function);
 	}
 
+/**
+ * Tests generating a MIN() function
+ *
+ * @return void
+ */
 	public function testMin() {
 		$function = $this->functions->min('created');
 		$this->assertInstanceOf('\Cake\Model\Datasource\Database\Expression\FunctionExpression', $function);
 		$this->assertEquals('MIN(created)', (string)$function);
 	}
 
+/**
+ * Tests generating a COUNT() function
+ *
+ * @return void
+ */
 	public function testCount() {
 		$function = $this->functions->count('*');
 		$this->assertInstanceOf('\Cake\Model\Datasource\Database\Expression\FunctionExpression', $function);
 		$this->assertEquals('COUNT(*)', (string)$function);
 	}
 
+/**
+ * Tests generating a CONCAT() function
+ *
+ * @return void
+ */
 	public function testConcat() {
 		$function = $this->functions->concat(['title' => 'literal', ' is a string']);
 		$this->assertInstanceOf('\Cake\Model\Datasource\Database\Expression\FunctionExpression', $function);
@@ -76,6 +116,11 @@ public function testConcat() {
 		$this->assertEquals("CONCAT(title, :$param)", (string)$function);
 	}
 
+/**
+ * Tests generating a COALESCE() function
+ *
+ * @return void
+ */
 	public function testCoalesce() {
 		$function = $this->functions->coalesce(['NULL' => 'literal', '1', '2']);
 		$this->assertInstanceOf('\Cake\Model\Datasource\Database\Expression\FunctionExpression', $function);
@@ -84,6 +129,11 @@ public function testCoalesce() {
 		$this->assertEquals("COALESCE(NULL, :$param, :$param2)", (string)$function);
 	}
 
+/**
+ * Tests generating a NOW(), CURRENT_TIME() and CURRENT_DATE() function
+ *
+ * @return void
+ */
 	public function testNow() {
 		$function = $this->functions->now();
 		$this->assertInstanceOf('\Cake\Model\Datasource\Database\Expression\FunctionExpression', $function);