Improve code organization and docblock.

Signed-off-by: crynobone <crynobone@gmail.com>

src/Orchestra/Facile/Environment.php

@@ -53,7 +53,7 @@ public function __construct()
 	 * @param  string   $name   Name of template
 	 * @param  array    $data
 	 * @param  string   $format
-	 * @return Orchestra\Facile\Response
+	 * @return \Orchestra\Facile\Response
 	 */
 	public function make($name, $data = array(), $format = null)
 	{
@@ -76,7 +76,9 @@ public function make($name, $data = array(), $format = null)
 	 * </code>
 	 * 
 	 * @access public
-	 * @return Orchestra\Facile\Response
+	 * @param  string   $view
+	 * @param  array    $data
+	 * @return \Orchestra\Facile\Response
 	 */
 	public function view($view, $data = array())
 	{
@@ -103,7 +105,7 @@ public function view($view, $data = array())
 	 *
 	 * @access public
 	 * @param  mixed    $data
-	 * @return Orchestra\Facile\Response
+	 * @return \Orchestra\Facile\Response
 	 */
 	public function with($data)
 	{
@@ -115,11 +117,11 @@ public function with($data)
 	/**
 	 * Register a template.
 	 *
-	 * @access public							
-	 * @param  string                           $name
-	 * @param  Orchestra\Facile\Template\Driver $callback
+	 * @access public
+	 * @param  string                               $name
+	 * @param  \Orchestra\Facile\Template\Driver    $callback
 	 * @return void
-	 * @throws RuntimeException     If $callback not instanceof 
+	 * @throws \RuntimeException    If $callback not instanceof 
 	 *                              Orchestra\Facile\Template\Driver
 	 */
 	public function template($name, $template)
@@ -141,8 +143,8 @@ public function template($name, $template)
 	 *
 	 * @access public
 	 * @param  string   $name
-	 * @return Orchestra\Facile\Template\Driver
-	 * @throws InvalidArgumentException     If template is not defined.
+	 * @return \Orchestra\Facile\Template\Driver
+	 * @throws \InvalidArgumentException    If template is not defined.
 	 */
 	public function get($name)
 	{

src/Orchestra/Facile/Response.php

@@ -8,14 +8,14 @@ class Response implements RenderableInterface {
 	/**
 	 * Environment instance.
 	 *
-	 * @var Orchestra\Facile\Environment
+	 * @var \Orchestra\Facile\Environment
 	 */
 	protected $env = null;
 
 	/**
 	 * Template instance.
 	 *
-	 * @var Orchestra\Facile\Template\Driver
+	 * @var \Orchestra\Facile\Template\Driver
 	 */
 	protected $template = null;
 
@@ -38,13 +38,13 @@ class Response implements RenderableInterface {
 	);
 
 	/**
-	 * Construct a new Facile\Response instance.
+	 * Construct a new Response instance.
 	 *
-	 * @access public							
-	 * @param  Orchestar\Facile\Environment     $env
-	 * @param  Orchestra\Facile\Template\Driver $template
-	 * @param  array                            $data
-	 * @param  string                           $format
+	 * @access public					
+	 * @param  \Orchestar\Facile\Environment        $env
+	 * @param  \Orchestra\Facile\Template\Driver    $template
+	 * @param  array                                $data
+	 * @param  string                               $format
 	 * @return void
 	 */
 	public function __construct(Environment $env, Template\Driver $template, $data = array(), $format = null)
@@ -128,7 +128,7 @@ public function template($name)
 	 *
 	 * @access public
 	 * @param  string   $format
-	 * @return string
+	 * @return self
 	 */
 	public function format($format = null)
 	{
@@ -149,18 +149,20 @@ public function format($format = null)
 	 *
 	 * @access public
 	 * @param  string   $format
-	 * @return void
+	 * @return self
 	 */
 	public function setFormat($format)
 	{
 		$this->format = $format;
+
+		return $this;
 	}
 
 	/**
 	 * Get Output Format.
 	 *
 	 * @access public
-	 * @return void
+	 * @return string
 	 */
 	public function getFormat()
 	{

src/Orchestra/Facile/Template/Base.php

@@ -14,20 +14,20 @@ class Base extends Driver {
 	protected $formats = array('html', 'json');
 
 	/**
-	 * Default format
+	 * Default format.
 	 *
 	 * @var string
 	 */
 	protected $defaultFormat = 'html';
 
 	/**
-	 * Compose HTML
+	 * Compose HTML.
 	 *
 	 * @access public
 	 * @param  mixed    $view
 	 * @param  array    $data
 	 * @param  integer  $status
-	 * @return string
+	 * @return \Illuminate\Http\Response
 	 */
 	public function composeHtml($view = null, $data = array(), $status = 200)
 	{
@@ -42,13 +42,13 @@ public function composeHtml($view = null, $data = array(), $status = 200)
 	}
 
 	/**
-	 * Compose json
+	 * Compose JSON.
 	 *
 	 * @access public
 	 * @param  mixed    $view
 	 * @param  array    $data
 	 * @param  integer  $status
-	 * @return string
+	 * @return \Illuminate\Http\JsonResponse
 	 */
 	public function composeJson($view, $data = array(), $status = 200)
 	{

src/Orchestra/Facile/Template/Driver.php

@@ -19,7 +19,7 @@ abstract class Driver {
 	protected $formats = array('html');
 
 	/**
-	 * Default format
+	 * Default format.
 	 *
 	 * @var string
 	 */
@@ -40,7 +40,10 @@ public function format()
 	 * Compose requested format.
 	 *
 	 * @access public
-	 * @return mixedd
+	 * @param  string   $format
+	 * @param  array    $compose
+	 * @return mixed
+	 * @throws \RuntimeException
 	 */
 	public function compose($format, $compose = array())
 	{
@@ -68,7 +71,7 @@ public function compose($format, $compose = array())
 	 * @param  mixed    $view
 	 * @param  array    $data
 	 * @param  integer 	$status
-	 * @return Response  
+	 * @return \Illuminate\Http\Response  
 	 */
 	public function composeError($view, $data = array(), $status = 404)
 	{
@@ -80,7 +83,7 @@ public function composeError($view, $data = array(), $status = 404)
 	}
 
 	/**
-	 * Transform given data
+	 * Transform given data.
 	 *
 	 * @access public
 	 * @param  array    $data
@@ -91,7 +94,7 @@ public function transform($item)
 		switch (true)
 		{
 			case ($item instanceof Eloquent) :
-				// passthru
+				# passthru;
 			case ($item instanceof ArrayableInterface) :
 				return $item->toArray();
 
@@ -108,7 +111,6 @@ public function transform($item)
 					'links'   => e($item->links()),
 				);
 
-
 			case (is_array($item)) :
 				return array_map(array($this, 'transform'), $item);