From 707ffe666d267613811a463cd344fa6432b9e9f0 Mon Sep 17 00:00:00 2001
From: Dan Ungureanu <udan1107@gmail.com>
Date: Fri, 26 Jun 2015 14:25:53 +0300
Subject: [PATCH] Updated sql-parser library.

Signed-off-by: Dan Ungureanu <udan1107@gmail.com>
---
 libraries/sql-parser/src/Context.php          | 10 +++++-
 .../src/Contexts/ContextMySql50000.php        |  5 +--
 .../src/Contexts/ContextMySql50100.php        |  5 +--
 .../src/Contexts/ContextMySql50500.php        |  5 +--
 .../src/Contexts/ContextMySql50600.php        |  5 +--
 .../src/Contexts/ContextMySql50700.php        |  5 +--
 .../src/Exceptions/LexerException.php         |  6 ++++
 .../src/Exceptions/ParserException.php        |  6 ++++
 libraries/sql-parser/src/Fragment.php         |  9 ++++++
 .../src/Fragments/ArrayFragment.php           |  6 ++++
 .../sql-parser/src/Fragments/CallKeyword.php  |  6 ++++
 .../src/Fragments/CreateDefFragment.php       |  6 ++++
 .../src/Fragments/DataTypeFragment.php        |  6 ++++
 .../src/Fragments/FieldDefFragment.php        |  8 +++++
 .../src/Fragments/FieldFragment.php           |  6 ++++
 .../sql-parser/src/Fragments/FromKeyword.php  |  6 ++++
 .../sql-parser/src/Fragments/IntoKeyword.php  |  6 ++++
 .../sql-parser/src/Fragments/JoinKeyword.php  |  6 ++++
 .../sql-parser/src/Fragments/KeyFragment.php  |  6 ++++
 .../sql-parser/src/Fragments/LimitKeyword.php |  6 ++++
 .../src/Fragments/OptionsFragment.php         | 10 ++++--
 .../sql-parser/src/Fragments/OrderKeyword.php |  6 ++++
 .../src/Fragments/ParamDefFragment.php        |  6 ++++
 .../src/Fragments/ReferencesKeyword.php       |  6 ++++
 .../src/Fragments/RenameKeyword.php           |  6 ++++
 .../src/Fragments/SelectKeyword.php           |  6 ++++
 .../sql-parser/src/Fragments/SetKeyword.php   |  6 ++++
 .../src/Fragments/ValuesKeyword.php           |  6 ++++
 .../sql-parser/src/Fragments/WhereKeyword.php |  6 ++++
 libraries/sql-parser/src/Lexer.php            |  9 ++++++
 libraries/sql-parser/src/Parser.php           |  9 ++++++
 libraries/sql-parser/src/Statement.php        | 22 +++++++++----
 .../src/Statements/AlterStatement.php         |  6 ++++
 .../src/Statements/AnalyzeStatement.php       |  6 ++++
 .../src/Statements/BackupStatement.php        |  6 ++++
 .../src/Statements/CallStatement.php          |  6 ++++
 .../src/Statements/CheckStatement.php         |  6 ++++
 .../src/Statements/ChecsumStatement.php       |  6 ++++
 .../src/Statements/CreateStatement.php        | 14 +++++---
 .../src/Statements/DeleteStatement.php        |  6 ++++
 .../src/Statements/DropStatement.php          |  6 ++++
 .../src/Statements/ExplainStatement.php       |  6 ++++
 .../src/Statements/InsertStatement.php        |  6 ++++
 .../src/Statements/MaintenanceStatement.php   | 18 +++++++----
 .../Statements/NotImplementedStatement.php    | 16 +++++++---
 .../src/Statements/OptimizeStatement.php      |  6 ++++
 .../src/Statements/RenameStatement.php        | 14 +++++---
 .../src/Statements/RepairStatement.php        |  6 ++++
 .../src/Statements/ReplaceStatement.php       |  6 ++++
 .../src/Statements/RestoreStatement.php       |  6 ++++
 .../src/Statements/SelectStatement.php        |  6 ++++
 .../src/Statements/ShowStatement.php          |  6 ++++
 .../src/Statements/UpdateStatement.php        |  6 ++++
 libraries/sql-parser/src/Token.php            |  7 ++++
 libraries/sql-parser/src/TokensList.php       |  5 +++
 libraries/sql-parser/src/UtfString.php        | 12 +++++++
 libraries/sql-parser/src/Utils/Misc.php       | 32 +++++++++++--------
 libraries/sql-parser/src/Utils/Query.php      | 12 +++++--
 libraries/sql-parser/src/Utils/Routine.php    | 14 +++++---
 libraries/sql-parser/src/Utils/Table.php      | 22 ++++++++-----
 60 files changed, 423 insertions(+), 67 deletions(-)

diff --git a/libraries/sql-parser/src/Context.php b/libraries/sql-parser/src/Context.php
index cbe666df57..699d800b87 100644
--- a/libraries/sql-parser/src/Context.php
+++ b/libraries/sql-parser/src/Context.php
@@ -1,9 +1,17 @@
 <?php
 
+/**
+ * Defines a context class that is later extended to define other contexts.
+ *
+ * A context is a collection of keywords, operators and functions used for
+ * parsing.
+ *
+ * @package SqlParser
+ */
 namespace SqlParser;
 
 /**
- * Default MySQL context.
+ * Holds the configuration of the context that is currently used.
  *
  * @category Contexts
  * @package  SqlParser
diff --git a/libraries/sql-parser/src/Contexts/ContextMySql50000.php b/libraries/sql-parser/src/Contexts/ContextMySql50000.php
index eedb59cb71..26afac1649 100644
--- a/libraries/sql-parser/src/Contexts/ContextMySql50000.php
+++ b/libraries/sql-parser/src/Contexts/ContextMySql50000.php
@@ -3,9 +3,10 @@
 /**
  * Context for MySQL 5.
  *
- * @link https://dev.mysql.com/doc/refman/5.0/en/keywords.html
+ * @package    SqlParser
+ * @subpackage Contexts
+ * @link       https://dev.mysql.com/doc/refman/5.0/en/keywords.html
  */
-
 namespace SqlParser\Contexts;
 
 use SqlParser\Context;
diff --git a/libraries/sql-parser/src/Contexts/ContextMySql50100.php b/libraries/sql-parser/src/Contexts/ContextMySql50100.php
index 5f70976478..23c619b797 100644
--- a/libraries/sql-parser/src/Contexts/ContextMySql50100.php
+++ b/libraries/sql-parser/src/Contexts/ContextMySql50100.php
@@ -3,9 +3,10 @@
 /**
  * Context for MySQL 5.1.
  *
- * @link https://dev.mysql.com/doc/refman/5.1/en/keywords.html
+ * @package    SqlParser
+ * @subpackage Contexts
+ * @link       https://dev.mysql.com/doc/refman/5.1/en/keywords.html
  */
-
 namespace SqlParser\Contexts;
 
 use SqlParser\Context;
diff --git a/libraries/sql-parser/src/Contexts/ContextMySql50500.php b/libraries/sql-parser/src/Contexts/ContextMySql50500.php
index db53f5e841..03105abd1b 100644
--- a/libraries/sql-parser/src/Contexts/ContextMySql50500.php
+++ b/libraries/sql-parser/src/Contexts/ContextMySql50500.php
@@ -3,9 +3,10 @@
 /**
  * Context for MySQL 5.5.
  *
- * @link https://dev.mysql.com/doc/refman/5.5/en/keywords.html
+ * @package    SqlParser
+ * @subpackage Contexts
+ * @link       https://dev.mysql.com/doc/refman/5.5/en/keywords.html
  */
-
 namespace SqlParser\Contexts;
 
 use SqlParser\Context;
diff --git a/libraries/sql-parser/src/Contexts/ContextMySql50600.php b/libraries/sql-parser/src/Contexts/ContextMySql50600.php
index 48fd6b2060..91978cbd82 100644
--- a/libraries/sql-parser/src/Contexts/ContextMySql50600.php
+++ b/libraries/sql-parser/src/Contexts/ContextMySql50600.php
@@ -3,9 +3,10 @@
 /**
  * Context for MySQL 5.6.
  *
- * @link https://dev.mysql.com/doc/refman/5.6/en/keywords.html
+ * @package    SqlParser
+ * @subpackage Contexts
+ * @link       https://dev.mysql.com/doc/refman/5.6/en/keywords.html
  */
-
 namespace SqlParser\Contexts;
 
 use SqlParser\Context;
diff --git a/libraries/sql-parser/src/Contexts/ContextMySql50700.php b/libraries/sql-parser/src/Contexts/ContextMySql50700.php
index ac55a6c96a..083740996e 100644
--- a/libraries/sql-parser/src/Contexts/ContextMySql50700.php
+++ b/libraries/sql-parser/src/Contexts/ContextMySql50700.php
@@ -3,9 +3,10 @@
 /**
  * Context for MySQL 5.7.
  *
- * @link https://dev.mysql.com/doc/refman/5.7/en/keywords.html
+ * @package    SqlParser
+ * @subpackage Contexts
+ * @link       https://dev.mysql.com/doc/refman/5.7/en/keywords.html
  */
-
 namespace SqlParser\Contexts;
 
 use SqlParser\Context;
diff --git a/libraries/sql-parser/src/Exceptions/LexerException.php b/libraries/sql-parser/src/Exceptions/LexerException.php
index 53327ed86f..886e662939 100644
--- a/libraries/sql-parser/src/Exceptions/LexerException.php
+++ b/libraries/sql-parser/src/Exceptions/LexerException.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * Exception thrown by the lexer.
+ *
+ * @package    SqlParser
+ * @subpackage Exceptions
+ */
 namespace SqlParser\Exceptions;
 
 use SqlParser\Token;
diff --git a/libraries/sql-parser/src/Exceptions/ParserException.php b/libraries/sql-parser/src/Exceptions/ParserException.php
index 06a6033da2..5a9fac0442 100644
--- a/libraries/sql-parser/src/Exceptions/ParserException.php
+++ b/libraries/sql-parser/src/Exceptions/ParserException.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * Exception thrown by the parser.
+ *
+ * @package    SqlParser
+ * @subpackage Exceptions
+ */
 namespace SqlParser\Exceptions;
 
 use SqlParser\Token;
diff --git a/libraries/sql-parser/src/Fragment.php b/libraries/sql-parser/src/Fragment.php
index 1c40699be3..a9a349ac23 100644
--- a/libraries/sql-parser/src/Fragment.php
+++ b/libraries/sql-parser/src/Fragment.php
@@ -1,5 +1,14 @@
 <?php
 
+/**
+ * Defines a fragment that is later extended to parse fragments or keywords.
+ *
+ * There is a small difference between *Fragment and *Keyword classes: usually,
+ * *Fragment parsers can be reused in multiple  situations and *Keyword parsers
+ * count on the *Fragment classes to do their job.
+ *
+ * @package SqlParser
+ */
 namespace SqlParser;
 
 /**
diff --git a/libraries/sql-parser/src/Fragments/ArrayFragment.php b/libraries/sql-parser/src/Fragments/ArrayFragment.php
index a713dde228..7ed22ad9c0 100644
--- a/libraries/sql-parser/src/Fragments/ArrayFragment.php
+++ b/libraries/sql-parser/src/Fragments/ArrayFragment.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * Parses an array.
+ *
+ * @package    SqlParser
+ * @subpackage Fragments
+ */
 namespace SqlParser\Fragments;
 
 use SqlParser\Fragment;
diff --git a/libraries/sql-parser/src/Fragments/CallKeyword.php b/libraries/sql-parser/src/Fragments/CallKeyword.php
index 4c1ed0c810..ae3c467f6a 100644
--- a/libraries/sql-parser/src/Fragments/CallKeyword.php
+++ b/libraries/sql-parser/src/Fragments/CallKeyword.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * Parses a function call.
+ *
+ * @package    SqlParser
+ * @subpackage Fragments
+ */
 namespace SqlParser\Fragments;
 
 use SqlParser\Fragment;
diff --git a/libraries/sql-parser/src/Fragments/CreateDefFragment.php b/libraries/sql-parser/src/Fragments/CreateDefFragment.php
index 58eabaaeba..403426c109 100644
--- a/libraries/sql-parser/src/Fragments/CreateDefFragment.php
+++ b/libraries/sql-parser/src/Fragments/CreateDefFragment.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * Parses the definition that follows the `CREATE` keyword.
+ *
+ * @package    SqlParser
+ * @subpackage Fragments
+ */
 namespace SqlParser\Fragments;
 
 use SqlParser\Fragment;
diff --git a/libraries/sql-parser/src/Fragments/DataTypeFragment.php b/libraries/sql-parser/src/Fragments/DataTypeFragment.php
index a8045cf3e8..2ad700a676 100644
--- a/libraries/sql-parser/src/Fragments/DataTypeFragment.php
+++ b/libraries/sql-parser/src/Fragments/DataTypeFragment.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * Parses a data type.
+ *
+ * @package    SqlParser
+ * @subpackage Fragments
+ */
 namespace SqlParser\Fragments;
 
 use SqlParser\Context;
diff --git a/libraries/sql-parser/src/Fragments/FieldDefFragment.php b/libraries/sql-parser/src/Fragments/FieldDefFragment.php
index 20983e9e37..d38eeda7c8 100644
--- a/libraries/sql-parser/src/Fragments/FieldDefFragment.php
+++ b/libraries/sql-parser/src/Fragments/FieldDefFragment.php
@@ -1,5 +1,13 @@
 <?php
 
+/**
+ * Parses the definition of a field.
+ *
+ * Used for parsing `CREATE TABLE` statement.
+ *
+ * @package    SqlParser
+ * @subpackage Fragments
+ */
 namespace SqlParser\Fragments;
 
 use SqlParser\Context;
diff --git a/libraries/sql-parser/src/Fragments/FieldFragment.php b/libraries/sql-parser/src/Fragments/FieldFragment.php
index 4a0c2cab07..51403248cb 100644
--- a/libraries/sql-parser/src/Fragments/FieldFragment.php
+++ b/libraries/sql-parser/src/Fragments/FieldFragment.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * Parses a reference to a field.
+ *
+ * @package    SqlParser
+ * @subpackage Fragments
+ */
 namespace SqlParser\Fragments;
 
 use SqlParser\Fragment;
diff --git a/libraries/sql-parser/src/Fragments/FromKeyword.php b/libraries/sql-parser/src/Fragments/FromKeyword.php
index aea9c3edc1..6fbf0ba365 100644
--- a/libraries/sql-parser/src/Fragments/FromKeyword.php
+++ b/libraries/sql-parser/src/Fragments/FromKeyword.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * `FROM` keyword parser.
+ *
+ * @package    SqlParser
+ * @subpackage Fragments
+ */
 namespace SqlParser\Fragments;
 
 use SqlParser\Fragment;
diff --git a/libraries/sql-parser/src/Fragments/IntoKeyword.php b/libraries/sql-parser/src/Fragments/IntoKeyword.php
index f5c9592b06..558b3e64c6 100644
--- a/libraries/sql-parser/src/Fragments/IntoKeyword.php
+++ b/libraries/sql-parser/src/Fragments/IntoKeyword.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * `INTO` keyword parser.
+ *
+ * @package    SqlParser
+ * @subpackage Fragments
+ */
 namespace SqlParser\Fragments;
 
 use SqlParser\Fragment;
diff --git a/libraries/sql-parser/src/Fragments/JoinKeyword.php b/libraries/sql-parser/src/Fragments/JoinKeyword.php
index b6b2c224e5..011bd4d80d 100644
--- a/libraries/sql-parser/src/Fragments/JoinKeyword.php
+++ b/libraries/sql-parser/src/Fragments/JoinKeyword.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * `JOIN` keyword parser.
+ *
+ * @package    SqlParser
+ * @subpackage Fragments
+ */
 namespace SqlParser\Fragments;
 
 use SqlParser\Fragment;
diff --git a/libraries/sql-parser/src/Fragments/KeyFragment.php b/libraries/sql-parser/src/Fragments/KeyFragment.php
index e1ac67908d..4a71857c90 100644
--- a/libraries/sql-parser/src/Fragments/KeyFragment.php
+++ b/libraries/sql-parser/src/Fragments/KeyFragment.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * Parses the definition of a key.
+ *
+ * @package    SqlParser
+ * @subpackage Fragments
+ */
 namespace SqlParser\Fragments;
 
 use SqlParser\Context;
diff --git a/libraries/sql-parser/src/Fragments/LimitKeyword.php b/libraries/sql-parser/src/Fragments/LimitKeyword.php
index 1e4ae4f3ef..261ef3e721 100644
--- a/libraries/sql-parser/src/Fragments/LimitKeyword.php
+++ b/libraries/sql-parser/src/Fragments/LimitKeyword.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * `lIMIT` keyword parser.
+ *
+ * @package    SqlParser
+ * @subpackage Fragments
+ */
 namespace SqlParser\Fragments;
 
 use SqlParser\Fragment;
diff --git a/libraries/sql-parser/src/Fragments/OptionsFragment.php b/libraries/sql-parser/src/Fragments/OptionsFragment.php
index dbd3676f4e..54d4857d2f 100644
--- a/libraries/sql-parser/src/Fragments/OptionsFragment.php
+++ b/libraries/sql-parser/src/Fragments/OptionsFragment.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * Parses a list of options.
+ *
+ * @package    SqlParser
+ * @subpackage Fragments
+ */
 namespace SqlParser\Fragments;
 
 use SqlParser\Fragment;
@@ -124,7 +130,7 @@ class OptionsFragment extends Fragment
     /**
      * Checks if it has the specified option and returns it value or true.
      *
-     * @param string $key
+     * @param string $key The key to be checked.
      *
      * @return mixed
      */
@@ -144,7 +150,7 @@ class OptionsFragment extends Fragment
      * Merges the specified options with these ones. Values with same ID will be
      * replaced.
      *
-     * @param array|OptionsFragment $options
+     * @param array|OptionsFragment $options The options to be merged.
      *
      * @return void
      */
diff --git a/libraries/sql-parser/src/Fragments/OrderKeyword.php b/libraries/sql-parser/src/Fragments/OrderKeyword.php
index 34744e3d1c..51942083fc 100644
--- a/libraries/sql-parser/src/Fragments/OrderKeyword.php
+++ b/libraries/sql-parser/src/Fragments/OrderKeyword.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * `ORDER BY` keyword parser.
+ *
+ * @package    SqlParser
+ * @subpackage Fragments
+ */
 namespace SqlParser\Fragments;
 
 use SqlParser\Fragment;
diff --git a/libraries/sql-parser/src/Fragments/ParamDefFragment.php b/libraries/sql-parser/src/Fragments/ParamDefFragment.php
index 4756120651..a51259658d 100644
--- a/libraries/sql-parser/src/Fragments/ParamDefFragment.php
+++ b/libraries/sql-parser/src/Fragments/ParamDefFragment.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * The definition of a parameter of a function or procedure.
+ *
+ * @package    SqlParser
+ * @subpackage Fragments
+ */
 namespace SqlParser\Fragments;
 
 use SqlParser\Context;
diff --git a/libraries/sql-parser/src/Fragments/ReferencesKeyword.php b/libraries/sql-parser/src/Fragments/ReferencesKeyword.php
index 939eb244ab..d4afd0194f 100644
--- a/libraries/sql-parser/src/Fragments/ReferencesKeyword.php
+++ b/libraries/sql-parser/src/Fragments/ReferencesKeyword.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * `REFERENCES` keyword parser.
+ *
+ * @package    SqlParser
+ * @subpackage Fragments
+ */
 namespace SqlParser\Fragments;
 
 use SqlParser\Fragment;
diff --git a/libraries/sql-parser/src/Fragments/RenameKeyword.php b/libraries/sql-parser/src/Fragments/RenameKeyword.php
index 9e9969c5f1..980ad7b022 100644
--- a/libraries/sql-parser/src/Fragments/RenameKeyword.php
+++ b/libraries/sql-parser/src/Fragments/RenameKeyword.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * `RENAME TABLE` keyword parser.
+ *
+ * @package    SqlParser
+ * @subpackage Fragments
+ */
 namespace SqlParser\Fragments;
 
 use SqlParser\Fragment;
diff --git a/libraries/sql-parser/src/Fragments/SelectKeyword.php b/libraries/sql-parser/src/Fragments/SelectKeyword.php
index fc59aa0261..5cf47199e3 100644
--- a/libraries/sql-parser/src/Fragments/SelectKeyword.php
+++ b/libraries/sql-parser/src/Fragments/SelectKeyword.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * `SELECT` keyword parser.
+ *
+ * @package    SqlParser
+ * @subpackage Fragments
+ */
 namespace SqlParser\Fragments;
 
 use SqlParser\Fragment;
diff --git a/libraries/sql-parser/src/Fragments/SetKeyword.php b/libraries/sql-parser/src/Fragments/SetKeyword.php
index 82f9965ba1..547768cb37 100644
--- a/libraries/sql-parser/src/Fragments/SetKeyword.php
+++ b/libraries/sql-parser/src/Fragments/SetKeyword.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * `SET` keyword parser.
+ *
+ * @package    SqlParser
+ * @subpackage Fragments
+ */
 namespace SqlParser\Fragments;
 
 use SqlParser\Fragment;
diff --git a/libraries/sql-parser/src/Fragments/ValuesKeyword.php b/libraries/sql-parser/src/Fragments/ValuesKeyword.php
index cb470dd6d9..6977f6811a 100644
--- a/libraries/sql-parser/src/Fragments/ValuesKeyword.php
+++ b/libraries/sql-parser/src/Fragments/ValuesKeyword.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * `VALUES` keyword parser.
+ *
+ * @package    SqlParser
+ * @subpackage Fragments
+ */
 namespace SqlParser\Fragments;
 
 use SqlParser\Fragment;
diff --git a/libraries/sql-parser/src/Fragments/WhereKeyword.php b/libraries/sql-parser/src/Fragments/WhereKeyword.php
index 0bc60a7dd9..1b36cc8a73 100644
--- a/libraries/sql-parser/src/Fragments/WhereKeyword.php
+++ b/libraries/sql-parser/src/Fragments/WhereKeyword.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * `WHERE` keyword parser.
+ *
+ * @package    SqlParser
+ * @subpackage Fragments
+ */
 namespace SqlParser\Fragments;
 
 use SqlParser\Fragment;
diff --git a/libraries/sql-parser/src/Lexer.php b/libraries/sql-parser/src/Lexer.php
index 33e7337937..d6814259d5 100644
--- a/libraries/sql-parser/src/Lexer.php
+++ b/libraries/sql-parser/src/Lexer.php
@@ -1,5 +1,14 @@
 <?php
 
+/**
+ * Defines the lexer of the library.
+ *
+ * This is one of the most important components, along with the parser.
+ *
+ * Depends on context to extract lexemes.
+ *
+ * @package SqlParser
+ */
 namespace SqlParser;
 
 use SqlParser\Exceptions\LexerException;
diff --git a/libraries/sql-parser/src/Parser.php b/libraries/sql-parser/src/Parser.php
index ba0a1440a0..a2f7ef768d 100644
--- a/libraries/sql-parser/src/Parser.php
+++ b/libraries/sql-parser/src/Parser.php
@@ -1,5 +1,12 @@
 <?php
 
+/**
+ * Defines the parser of the library.
+ *
+ * This is one of the most important components, along with the lexer.
+ *
+ * @package SqlParser
+ */
 namespace SqlParser;
 
 use SqlParser\Exceptions\ParserException;
@@ -286,6 +293,8 @@ class Parser
      * @param string $msg   The error message.
      * @param Token  $token The token that produced the error.
      * @param int    $code  The code of the error.
+     *
+     * @return void
      */
     public function error($msg = '', Token $token = null, $code = 0)
     {
diff --git a/libraries/sql-parser/src/Statement.php b/libraries/sql-parser/src/Statement.php
index 1b7e590dce..a813fff2db 100644
--- a/libraries/sql-parser/src/Statement.php
+++ b/libraries/sql-parser/src/Statement.php
@@ -1,5 +1,13 @@
 <?php
 
+/**
+ * The result of the parser is an array of statements are extensions of the
+ * class defined here.
+ *
+ * A statement represents the result of parsing the lexemes.
+ *
+ * @package SqlParser.
+ */
 namespace SqlParser;
 
 use SqlParser\Parser;
@@ -132,9 +140,9 @@ abstract class Statement
     /**
      * Function called before the token was processed.
      *
-     * @param  Parser     $parser   The instance that requests parsing.
-     * @param  TokensList $list The list of tokens to be parsed.
-     * @param  Token      $token The token that is being parsed.
+     * @param Parser     $parser The instance that requests parsing.
+     * @param TokensList $list   The list of tokens to be parsed.
+     * @param Token      $token  The token that is being parsed.
      *
      * @return void
      */
@@ -146,11 +154,11 @@ abstract class Statement
     /**
      * Function called after the token was processed.
      *
-     * @param  Parser     $parser   The instance that requests parsing.
-     * @param  TokensList $list The list of tokens to be parsed.
-     * @param  Token      $token The token that is being parsed.
+     * @param Parser     $parser The instance that requests parsing.
+     * @param TokensList $list   The list of tokens to be parsed.
+     * @param Token      $token  The token that is being parsed.
      *
-     * @return
+     * @return void
      */
     public function after(Parser $parser, TokensList $list, Token $token)
     {
diff --git a/libraries/sql-parser/src/Statements/AlterStatement.php b/libraries/sql-parser/src/Statements/AlterStatement.php
index 4cc29cdefa..1d6b44ca96 100644
--- a/libraries/sql-parser/src/Statements/AlterStatement.php
+++ b/libraries/sql-parser/src/Statements/AlterStatement.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * `ALTER` statement.
+ *
+ * @package    SqlParser
+ * @subpackage Statements
+ */
 namespace SqlParser\Statements;
 
 use SqlParser\Statements\NotImplementedStatement;
diff --git a/libraries/sql-parser/src/Statements/AnalyzeStatement.php b/libraries/sql-parser/src/Statements/AnalyzeStatement.php
index 78783f2a54..850a27aa4f 100644
--- a/libraries/sql-parser/src/Statements/AnalyzeStatement.php
+++ b/libraries/sql-parser/src/Statements/AnalyzeStatement.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * `ANALYZE` statement.
+ *
+ * @package    SqlParser
+ * @subpackage Statements
+ */
 namespace SqlParser\Statements;
 
 use SqlParser\Statement;
diff --git a/libraries/sql-parser/src/Statements/BackupStatement.php b/libraries/sql-parser/src/Statements/BackupStatement.php
index cc2e07e256..c8e0977a2c 100644
--- a/libraries/sql-parser/src/Statements/BackupStatement.php
+++ b/libraries/sql-parser/src/Statements/BackupStatement.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * `BACKUP` statement.
+ *
+ * @package    SqlParser
+ * @subpackage Statements
+ */
 namespace SqlParser\Statements;
 
 use SqlParser\Statements\MaintenanceStatement;
diff --git a/libraries/sql-parser/src/Statements/CallStatement.php b/libraries/sql-parser/src/Statements/CallStatement.php
index 162f50eafa..0e83282007 100644
--- a/libraries/sql-parser/src/Statements/CallStatement.php
+++ b/libraries/sql-parser/src/Statements/CallStatement.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * `CALL` statement.
+ *
+ * @package    SqlParser
+ * @subpackage Statements
+ */
 namespace SqlParser\Statements;
 
 use SqlParser\Statement;
diff --git a/libraries/sql-parser/src/Statements/CheckStatement.php b/libraries/sql-parser/src/Statements/CheckStatement.php
index 4619613c2f..38764ff869 100644
--- a/libraries/sql-parser/src/Statements/CheckStatement.php
+++ b/libraries/sql-parser/src/Statements/CheckStatement.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * `CHECK` statement.
+ *
+ * @package    SqlParser
+ * @subpackage Statements
+ */
 namespace SqlParser\Statements;
 
 use SqlParser\Statements\MaintenanceStatement;
diff --git a/libraries/sql-parser/src/Statements/ChecsumStatement.php b/libraries/sql-parser/src/Statements/ChecsumStatement.php
index 36426d2afc..e2c6371c12 100644
--- a/libraries/sql-parser/src/Statements/ChecsumStatement.php
+++ b/libraries/sql-parser/src/Statements/ChecsumStatement.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * `CHECKSUM` statement.
+ *
+ * @package    SqlParser
+ * @subpackage Statements
+ */
 namespace SqlParser\Statements;
 
 use SqlParser\Statements\MaintenanceStatement;
diff --git a/libraries/sql-parser/src/Statements/CreateStatement.php b/libraries/sql-parser/src/Statements/CreateStatement.php
index b5d56fef3f..ef11537d99 100644
--- a/libraries/sql-parser/src/Statements/CreateStatement.php
+++ b/libraries/sql-parser/src/Statements/CreateStatement.php
@@ -1,10 +1,16 @@
 <?php
 
+/**
+ * `CREATE` statement.
+ *
+ * @package    SqlParser
+ * @subpackage Statements
+ */
 namespace SqlParser\Statements;
 
 use SqlParser\Parser;
 use SqlParser\Statement;
-use sqlParser\Token;
+use SqlParser\Token;
 use SqlParser\TokensList;
 use SqlParser\Fragments\CreateDefFragment;
 use SqlParser\Fragments\DataTypeFragment;
@@ -96,9 +102,9 @@ class CreateStatement extends Statement
     /**
      * Parsing the `CREATE` statement.
      *
-     * @param  Parser     $parser   The instance that requests parsing.
-     * @param  TokensList $list The list of tokens to be parsed.
-     * @param  Token      $token The token that is being parsed.
+     * @param Parser     $parser The instance that requests parsing.
+     * @param TokensList $list   The list of tokens to be parsed.
+     * @param Token      $token  The token that is being parsed.
      *
      * @return void
      */
diff --git a/libraries/sql-parser/src/Statements/DeleteStatement.php b/libraries/sql-parser/src/Statements/DeleteStatement.php
index e7f3a69f75..9016da37de 100644
--- a/libraries/sql-parser/src/Statements/DeleteStatement.php
+++ b/libraries/sql-parser/src/Statements/DeleteStatement.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * `DELETE` statement.
+ *
+ * @package    SqlParser
+ * @subpackage Statements
+ */
 namespace SqlParser\Statements;
 
 use SqlParser\Statement;
diff --git a/libraries/sql-parser/src/Statements/DropStatement.php b/libraries/sql-parser/src/Statements/DropStatement.php
index de96de728b..716ca54f84 100644
--- a/libraries/sql-parser/src/Statements/DropStatement.php
+++ b/libraries/sql-parser/src/Statements/DropStatement.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * `DROP` statement.
+ *
+ * @package    SqlParser
+ * @subpackage Statements
+ */
 namespace SqlParser\Statements;
 
 use SqlParser\Statement;
diff --git a/libraries/sql-parser/src/Statements/ExplainStatement.php b/libraries/sql-parser/src/Statements/ExplainStatement.php
index 8670b08c1f..2a34b0d77e 100644
--- a/libraries/sql-parser/src/Statements/ExplainStatement.php
+++ b/libraries/sql-parser/src/Statements/ExplainStatement.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * `EXPLAIN` statement.
+ *
+ * @package    SqlParser
+ * @subpackage Statements
+ */
 namespace SqlParser\Statements;
 
 use SqlParser\Statements\NotImplementedStatement;
diff --git a/libraries/sql-parser/src/Statements/InsertStatement.php b/libraries/sql-parser/src/Statements/InsertStatement.php
index c80e194966..385e4bf03e 100644
--- a/libraries/sql-parser/src/Statements/InsertStatement.php
+++ b/libraries/sql-parser/src/Statements/InsertStatement.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * `INSERT` statement.
+ *
+ * @package    SqlParser
+ * @subpackage Statements
+ */
 namespace SqlParser\Statements;
 
 use SqlParser\Statement;
diff --git a/libraries/sql-parser/src/Statements/MaintenanceStatement.php b/libraries/sql-parser/src/Statements/MaintenanceStatement.php
index b26e1c0509..a0df6343df 100644
--- a/libraries/sql-parser/src/Statements/MaintenanceStatement.php
+++ b/libraries/sql-parser/src/Statements/MaintenanceStatement.php
@@ -1,15 +1,21 @@
 <?php
 
+/**
+ * Maintenance statement.
+ *
+ * @package    SqlParser
+ * @subpackage Statements
+ */
 namespace SqlParser\Statements;
 
 use SqlParser\Parser;
 use SqlParser\Statement;
-use sqlParser\Token;
+use SqlParser\Token;
 use SqlParser\TokensList;
 use SqlParser\Fragments\OptionsFragment;
 
 /**
- * Maintenance statements.
+ * Maintenance statement.
  *
  * They follow the syntax:
  *     STMT [some options] tbl_name [, tbl_name] ... [some more options]
@@ -33,11 +39,11 @@ class MaintenanceStatement extends Statement
     /**
      * Parses the additional options fragment at the end.
      *
-     * @param  Parser     $parser   The instance that requests parsing.
-     * @param  TokensList $list The list of tokens to be parsed.
-     * @param  Token      $token The token that is being parsed.
+     * @param Parser     $parser The instance that requests parsing.
+     * @param TokensList $list   The list of tokens to be parsed.
+     * @param Token      $token  The token that is being parsed.
      *
-     * @return
+     * @return void
      */
     public function after(Parser $parser, TokensList $list, Token $token)
     {
diff --git a/libraries/sql-parser/src/Statements/NotImplementedStatement.php b/libraries/sql-parser/src/Statements/NotImplementedStatement.php
index 9f9f61cd09..1ad5cc50ef 100644
--- a/libraries/sql-parser/src/Statements/NotImplementedStatement.php
+++ b/libraries/sql-parser/src/Statements/NotImplementedStatement.php
@@ -1,10 +1,16 @@
 <?php
 
+/**
+ * Not implemented (yet) statements.
+ *
+ * @package    SqlParser
+ * @subpackage Statements
+ */
 namespace SqlParser\Statements;
 
 use SqlParser\Parser;
 use SqlParser\Statement;
-use sqlParser\Token;
+use SqlParser\Token;
 use SqlParser\TokensList;
 
 /**
@@ -24,11 +30,11 @@ class NotImplementedStatement extends Statement
     /**
      * Jump to the end of the delimiter.
      *
-     * @param  Parser     $parser   The instance that requests parsing.
-     * @param  TokensList $list The list of tokens to be parsed.
-     * @param  Token      $token The token that is being parsed.
+     * @param Parser     $parser The instance that requests parsing.
+     * @param TokensList $list   The list of tokens to be parsed.
+     * @param Token      $token  The token that is being parsed.
      *
-     * @return
+     * @return void
      */
     public function before(Parser $parser, TokensList $list, Token $token)
     {
diff --git a/libraries/sql-parser/src/Statements/OptimizeStatement.php b/libraries/sql-parser/src/Statements/OptimizeStatement.php
index 0b7b38aa3d..f163b8705e 100644
--- a/libraries/sql-parser/src/Statements/OptimizeStatement.php
+++ b/libraries/sql-parser/src/Statements/OptimizeStatement.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * `OPTIMIZE` statement.
+ *
+ * @package    SqlParser
+ * @subpackage Statements
+ */
 namespace SqlParser\Statements;
 
 use SqlParser\Statement;
diff --git a/libraries/sql-parser/src/Statements/RenameStatement.php b/libraries/sql-parser/src/Statements/RenameStatement.php
index 0f5a1c7f8d..5ebd2faac4 100644
--- a/libraries/sql-parser/src/Statements/RenameStatement.php
+++ b/libraries/sql-parser/src/Statements/RenameStatement.php
@@ -1,10 +1,16 @@
 <?php
 
+/**
+ * `RENAME` statement.
+ *
+ * @package    SqlParser
+ * @subpackage Statements
+ */
 namespace SqlParser\Statements;
 
 use SqlParser\Parser;
 use SqlParser\Statement;
-use sqlParser\Token;
+use SqlParser\Token;
 use SqlParser\TokensList;
 
 /**
@@ -32,9 +38,9 @@ class RenameStatement extends Statement
     /**
      * Skips the `TABLE` keyword after `RENAME`.
      *
-     * @param  Parser     $parser   The instance that requests parsing.
-     * @param  TokensList $list The list of tokens to be parsed.
-     * @param  Token      $token The token that is being parsed.
+     * @param Parser     $parser The instance that requests parsing.
+     * @param TokensList $list   The list of tokens to be parsed.
+     * @param Token      $token  The token that is being parsed.
      *
      * @return void
      */
diff --git a/libraries/sql-parser/src/Statements/RepairStatement.php b/libraries/sql-parser/src/Statements/RepairStatement.php
index d4053ee375..933d2c0d08 100644
--- a/libraries/sql-parser/src/Statements/RepairStatement.php
+++ b/libraries/sql-parser/src/Statements/RepairStatement.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * `REPAIR` statement.
+ *
+ * @package    SqlParser
+ * @subpackage Statements
+ */
 namespace SqlParser\Statements;
 
 use SqlParser\Statements\MaintenanceStatement;
diff --git a/libraries/sql-parser/src/Statements/ReplaceStatement.php b/libraries/sql-parser/src/Statements/ReplaceStatement.php
index 0411f45807..8df7cb462a 100644
--- a/libraries/sql-parser/src/Statements/ReplaceStatement.php
+++ b/libraries/sql-parser/src/Statements/ReplaceStatement.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * `REPLACE` statement.
+ *
+ * @package    SqlParser
+ * @subpackage Statements
+ */
 namespace SqlParser\Statements;
 
 use SqlParser\Statement;
diff --git a/libraries/sql-parser/src/Statements/RestoreStatement.php b/libraries/sql-parser/src/Statements/RestoreStatement.php
index 89e2ed5222..996b41eb0b 100644
--- a/libraries/sql-parser/src/Statements/RestoreStatement.php
+++ b/libraries/sql-parser/src/Statements/RestoreStatement.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * `RESTORE` statement.
+ *
+ * @package    SqlParser
+ * @subpackage Statements
+ */
 namespace SqlParser\Statements;
 
 use SqlParser\Statements\MaintenanceStatement;
diff --git a/libraries/sql-parser/src/Statements/SelectStatement.php b/libraries/sql-parser/src/Statements/SelectStatement.php
index 4b9584f58d..8cdee820e5 100644
--- a/libraries/sql-parser/src/Statements/SelectStatement.php
+++ b/libraries/sql-parser/src/Statements/SelectStatement.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * `SELECT` statement.
+ *
+ * @package    SqlParser
+ * @subpackage Statements
+ */
 namespace SqlParser\Statements;
 
 use SqlParser\Statement;
diff --git a/libraries/sql-parser/src/Statements/ShowStatement.php b/libraries/sql-parser/src/Statements/ShowStatement.php
index 57a411055d..02da79d54a 100644
--- a/libraries/sql-parser/src/Statements/ShowStatement.php
+++ b/libraries/sql-parser/src/Statements/ShowStatement.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * `SHOW` statement.
+ *
+ * @package    SqlParser
+ * @subpackage Statements
+ */
 namespace SqlParser\Statements;
 
 use SqlParser\Statements\NotImplementedStatement;
diff --git a/libraries/sql-parser/src/Statements/UpdateStatement.php b/libraries/sql-parser/src/Statements/UpdateStatement.php
index 39a0f1c227..d100560b30 100644
--- a/libraries/sql-parser/src/Statements/UpdateStatement.php
+++ b/libraries/sql-parser/src/Statements/UpdateStatement.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * `UPDATE` statement.
+ *
+ * @package    SqlParser
+ * @subpackage Statements
+ */
 namespace SqlParser\Statements;
 
 use SqlParser\Statement;
diff --git a/libraries/sql-parser/src/Token.php b/libraries/sql-parser/src/Token.php
index 160efcda3d..fa23d2870f 100644
--- a/libraries/sql-parser/src/Token.php
+++ b/libraries/sql-parser/src/Token.php
@@ -1,5 +1,12 @@
 <?php
 
+/**
+ * Defines a token along with a set of types and flags and utility functions.
+ *
+ * An array of tokens will result after parsing the query.
+ *
+ * @package SqlParser
+ */
 namespace SqlParser;
 
 /**
diff --git a/libraries/sql-parser/src/TokensList.php b/libraries/sql-parser/src/TokensList.php
index 533fb0b3ab..6365be6e3b 100644
--- a/libraries/sql-parser/src/TokensList.php
+++ b/libraries/sql-parser/src/TokensList.php
@@ -1,5 +1,10 @@
 <?php
 
+/**
+ * Defines an array of tokens and utility functions to iterate through it.
+ *
+ * @package SqlParser
+ */
 namespace SqlParser;
 
 /**
diff --git a/libraries/sql-parser/src/UtfString.php b/libraries/sql-parser/src/UtfString.php
index e98ee3f05f..bab15afe1d 100644
--- a/libraries/sql-parser/src/UtfString.php
+++ b/libraries/sql-parser/src/UtfString.php
@@ -1,5 +1,17 @@
 <?php
 
+/**
+ * Implementation for UTF-8 strings.
+ *
+ * The subscript operator in PHP, when used with string will return a byte
+ * and not a character. Because in UTF-8 strings a character may occupy more
+ * than one byte, the subscript operator may return an invalid character.
+ *
+ * Because the lexer relies on the subscript operator this class had to be
+ * implemented.
+ *
+ * @package SqlParser
+ */
 namespace SqlParser;
 
 /**
diff --git a/libraries/sql-parser/src/Utils/Misc.php b/libraries/sql-parser/src/Utils/Misc.php
index 55ae33b7c1..85c2399b9d 100644
--- a/libraries/sql-parser/src/Utils/Misc.php
+++ b/libraries/sql-parser/src/Utils/Misc.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * Miscellaneous utilities.
+ *
+ * @package    SqlParser
+ * @subpackage Utils
+ */
 namespace SqlParser\Utils;
 
 use SqlParser\Statement;
@@ -20,14 +26,14 @@ class Misc
     /**
      * Gets a list of all aliases and their original names.
      *
-     * @param SelectStatement $tree     The tree that was generated after parsing.
-     * @param string          $database The name of the database.
+     * @param SelectStatement $statement The statement to be processed.
+     * @param string          $database  The name of the database.
      *
      * @return array
      */
-    public static function getAliases($tree, $database)
+    public static function getAliases($statement, $database)
     {
-        if ((empty($tree->from)) || (empty($tree->expr))) {
+        if ((empty($statement->from)) || (empty($statement->expr))) {
             return array();
         }
 
@@ -35,28 +41,28 @@ class Misc
 
         $tables = array();
 
-        if ((!empty($tree->join->expr->table))
-            && (!empty($tree->join->expr->alias))
+        if ((!empty($statement->join->expr->table))
+            && (!empty($statement->join->expr->alias))
         ) {
-            $thisDb = empty($tree->join->expr->database) ?
-                $database : $tree->join->expr->database;
+            $thisDb = empty($statement->join->expr->database) ?
+                $database : $statement->join->expr->database;
 
             $retval = array(
                 $thisDb => array(
                     'alias' => null,
                     'tables' => array(
-                        $tree->join->expr->table => array(
-                            'alias' => $tree->join->expr->alias,
+                        $statement->join->expr->table => array(
+                            'alias' => $statement->join->expr->alias,
                             'columns' => array(),
                         ),
                     ),
                 ),
             );
 
-            $tables[$thisDb][$tree->join->expr->alias] = $tree->join->expr->table;
+            $tables[$thisDb][$statement->join->expr->alias] = $statement->join->expr->table;
         }
 
-        foreach ($tree->from as $expr) {
+        foreach ($statement->from as $expr) {
             if (empty($expr->table)) {
                 continue;
             }
@@ -83,7 +89,7 @@ class Misc
             $tables[$thisDb][$expr->alias] = $expr->table;
         }
 
-        foreach ($tree->expr as $expr) {
+        foreach ($statement->expr as $expr) {
             if ((empty($expr->column)) || (empty($expr->alias))) {
                 continue;
             }
diff --git a/libraries/sql-parser/src/Utils/Query.php b/libraries/sql-parser/src/Utils/Query.php
index c3083441ea..b1a95b155c 100644
--- a/libraries/sql-parser/src/Utils/Query.php
+++ b/libraries/sql-parser/src/Utils/Query.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * Statement utilities.
+ *
+ * @package    SqlParser
+ * @subpackage Utils
+ */
 namespace SqlParser\Utils;
 
 use SqlParser\Parser;
@@ -45,8 +51,8 @@ class Query
     /**
      * Gets an array with flags this statement has.
      *
-     * @param Statement $statement
-     * @param bool $all If `false`, false values will not be included.
+     * @param Statement $statement The statement to be processed.
+     * @param bool      $all       If `false`, false values will not be included.
      *
      * @return array
      */
@@ -164,7 +170,7 @@ class Query
     /**
      * Parses a query and gets all information about it.
      *
-     * @param  string $query
+     * @param string $query The query to be parsed.
      *
      * @return array
      */
diff --git a/libraries/sql-parser/src/Utils/Routine.php b/libraries/sql-parser/src/Utils/Routine.php
index 76d3d71f28..4b9b21daef 100644
--- a/libraries/sql-parser/src/Utils/Routine.php
+++ b/libraries/sql-parser/src/Utils/Routine.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * Routine utilities.
+ *
+ * @package    SqlParser
+ * @subpackage Utils
+ */
 namespace SqlParser\Utils;
 
 use SqlParser\Lexer;
@@ -90,11 +96,11 @@ class Routine
     /**
      * Gets the parameters of a routine from the parse tree.
      *
-     * @param CreateStatement $tree The tree that was generated after parsing.
+     * @param CreateStatement $statement The statement to be processed.
      *
      * @return array
      */
-    public static function getParameters($tree)
+    public static function getParameters($statement)
     {
         $retval = array(
             'num' => 0,
@@ -106,9 +112,9 @@ class Routine
             'opts' => array(),
         );
 
-        if (!empty($tree->parameters)) {
+        if (!empty($statement->parameters)) {
             $idx = 0;
-            foreach ($tree->parameters as $param) {
+            foreach ($statement->parameters as $param) {
                 $retval['dir'][$idx] = $param->inOut;
                 $retval['name'][$idx] = $param->name;
                 $retval['type'][$idx] = $param->type->name;
diff --git a/libraries/sql-parser/src/Utils/Table.php b/libraries/sql-parser/src/Utils/Table.php
index 6bc83a501f..95b685001c 100644
--- a/libraries/sql-parser/src/Utils/Table.php
+++ b/libraries/sql-parser/src/Utils/Table.php
@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * Table utilities.
+ *
+ * @package    SqlParser
+ * @subpackage Utils
+ */
 namespace SqlParser\Utils;
 
 use SqlParser\Lexer;
@@ -24,19 +30,19 @@ class Table
     /**
      * Gets the foreign keys of the table.
      *
-     * @param CreateStatement $tree
+     * @param CreateStatement $statement The statement to be processed.
      *
      * @return array
      */
-    public static function getForeignKeys($tree)
+    public static function getForeignKeys($statement)
     {
-        if ((empty($tree->fields)) || (!$tree->options->has('TABLE'))) {
+        if ((empty($statement->fields)) || (!$statement->options->has('TABLE'))) {
             return array();
         }
 
         $ret = array();
 
-        foreach ($tree->fields as $field) {
+        foreach ($statement->fields as $field) {
 
             if ((empty($field->key)) || ($field->key->type !== 'FOREIGN KEY')) {
                 continue;
@@ -74,19 +80,19 @@ class Table
     /**
      * Gets fields of the table.
      *
-     * @param CreateStatement $tree
+     * @param CreateStatement $statement The statement to be processed.
      *
      * @return array
      */
-    public static function getFields($tree)
+    public static function getFields($statement)
     {
-        if ((empty($tree->fields)) || (!$tree->options->has('TABLE'))) {
+        if ((empty($statement->fields)) || (!$statement->options->has('TABLE'))) {
             return array();
         }
 
         $ret = array();
 
-        foreach ($tree->fields as $field) {
+        foreach ($statement->fields as $field) {
 
             // Skipping keys.
             if (empty($field->type)) {