From c55dfde6269d563be40b3186b7551a2405925d33 Mon Sep 17 00:00:00 2001
From: Dennis Eichhorn <spl1nes.com@googlemail.com>
Date: Sun, 11 Sep 2016 22:47:05 +0200
Subject: [PATCH] Commenting

---
 DataStorage/Database/Query/Builder.php | 52 ++++++++++++++++++++++++--
 1 file changed, 48 insertions(+), 4 deletions(-)

diff --git a/DataStorage/Database/Query/Builder.php b/DataStorage/Database/Query/Builder.php
index 63d9563c5..e0427dfbd 100644
--- a/DataStorage/Database/Query/Builder.php
+++ b/DataStorage/Database/Query/Builder.php
@@ -153,14 +153,20 @@ class Builder extends BuilderAbstract
      */
     public $lock = false;
 
+    /**
+     * Raw query.
+     *
+     * @var bool
+     * @since 1.0.0
+     */
+    public $raw = '';
+
     protected $unionLimit = null;
 
     protected $unionOffset = null;
 
     protected $unionOrders = [];
 
-    public $raw = '';
-
     /**
      * Comparison operators.
      *
@@ -210,6 +216,16 @@ class Builder extends BuilderAbstract
         $this->setConnection($connection);
     }
 
+    /**
+     * Set connection for grammar.
+     *
+     * @param ConnectionAbstract $connection Database connection
+     *
+     * @return  void
+     *
+     * @since  1.0.0
+     * @author Dennis Eichhorn <d.eichhorn@oms.com>
+     */
     public function setConnection(ConnectionAbstract $connection)
     {
         $this->connection = $connection;
@@ -230,8 +246,6 @@ class Builder extends BuilderAbstract
      */
     public function select(...$columns) : Builder
     {
-        // todo handle wrong parameters
-
         $this->type = QueryType::SELECT;
 
         foreach ($columns as $key => $column) {
@@ -315,6 +329,16 @@ class Builder extends BuilderAbstract
         return $this->grammar->compileQuery($this);
     }
 
+    /**
+     * Set raw query.
+     *
+     * @param  string $raw Raw query
+     *
+     * @return Builder
+     *
+     * @since  1.0.0
+     * @author Dennis Eichhorn <d.eichhorn@oms.com>
+     */
     public function raw(string $raw) : Builder
     {
         $this->type = QueryType::RAW;
@@ -447,6 +471,16 @@ class Builder extends BuilderAbstract
         return $this;
     }
 
+    /**
+     * Where and sub condition.
+     *
+     * @param Where $where Where sub condition
+     *
+     * @return Builder
+     *
+     * @since  1.0.0
+     * @author Dennis Eichhorn <d.eichhorn@oms.com>
+     */
     public function andWhere(Where $where)
     {
         $this->wheres[][] = [
@@ -457,6 +491,16 @@ class Builder extends BuilderAbstract
         return $this;
     }
 
+    /**
+     * Where or sub condition.
+     *
+     * @param Where $where Where sub condition
+     *
+     * @return Builder
+     *
+     * @since  1.0.0
+     * @author Dennis Eichhorn <d.eichhorn@oms.com>
+     */
     public function orWhere(Where $where)
     {
         $this->wheres[][] = [