Added comments and reformated some code

Author: paquettg

src/PHPHtmlParser/Content.php

@@ -1,6 +1,11 @@
 <?php
 namespace PHPHtmlParser;
 
+/**
+ * Class Content
+ *
+ * @package PHPHtmlParser
+ */
 class Content {
 
 	/**
@@ -32,15 +37,25 @@ class Content {
 	protected $blank = " \t\r\n";
 	protected $equal = ' =/>';
 	protected $slash = " />\r\n\t";
-	protected $attr  = ' >';
+	protected $attr = ' >';
 
+	/**
+	 * Content constructor.
+	 *
+	 * @param $content
+	 */
 	public function __construct($content)
 	{
 		$this->content = $content;
 		$this->size    = strlen($content);
 		$this->pos     = 0;
 	}
 
+	/**
+	 * Returns the current position of the content.
+	 *
+	 * @return int
+	 */
 	public function getPosition()
 	{
 		return $this->pos;
@@ -77,6 +92,7 @@ public function char($char = null)
 	public function fastForward($count)
 	{
 		$this->pos += $count;
+
 		return $this;
 	}
 
@@ -93,6 +109,7 @@ public function rewind($count)
 		{
 			$this->pos = 0;
 		}
+
 		return $this;
 	}
 
@@ -115,8 +132,8 @@ public function copyUntil($string, $char = false, $escape = false)
 		if ($escape)
 		{
 			$position = $this->pos;
-			$found	  = false;
-			while( ! $found)
+			$found    = false;
+			while ( ! $found)
 			{
 				$position = strpos($this->content, $string, $position);
 				if ($position === false)
@@ -138,7 +155,7 @@ public function copyUntil($string, $char = false, $escape = false)
 		}
 		elseif ($char)
 		{
-			$position  = strcspn($this->content, $string, $this->pos);
+			$position = strcspn($this->content, $string, $this->pos);
 			$position += $this->pos;
 		}
 		else
@@ -151,6 +168,7 @@ public function copyUntil($string, $char = false, $escape = false)
 			// could not find character, just return the remaining of the content
 			$return    = substr($this->content, $this->pos, $this->size - $this->pos);
 			$this->pos = $this->size;
+
 			return $return;
 		}
 
@@ -163,6 +181,7 @@ public function copyUntil($string, $char = false, $escape = false)
 		$return = substr($this->content, $this->pos, $position - $this->pos);
 		// set the new position
 		$this->pos = $position;
+
 		return $return;
 	}
 
@@ -187,6 +206,7 @@ public function copyUntilUnless($string, $unless)
 		}
 		// rewind changes and return nothing
 		$this->pos = $lastPos;
+
 		return '';
 	}
 
@@ -202,6 +222,7 @@ public function copyUntilUnless($string, $unless)
 	public function copyByToken($token, $char = false, $escape = false)
 	{
 		$string = $this->$token;
+
 		return $this->copyUntil($string, $char, $escape);
 	}
 
@@ -215,7 +236,7 @@ public function copyByToken($token, $char = false, $escape = false)
 	public function skip($string, $copy = false)
 	{
 		$len = strspn($this->content, $string, $this->pos);
-		
+
 		// make it chainable if they don't want a copy
 		$return = $this;
 		if ($copy)
@@ -240,6 +261,7 @@ public function skip($string, $copy = false)
 	public function skipByToken($token, $copy = false)
 	{
 		$string = $this->$token;
+
 		return $this->skip($string, $copy);
 	}
 }

src/PHPHtmlParser/Curl.php

@@ -3,8 +3,13 @@
 
 use PHPHtmlParser\Exceptions\CurlException;
 
+/**
+ * Class Curl
+ *
+ * @package PHPHtmlParser
+ */
 class Curl implements CurlInterface {
-	
+
 	/**
 	 * A simple curl implementation to get the content of the url.
 	 *
@@ -15,11 +20,12 @@ class Curl implements CurlInterface {
 	public function get($url)
 	{
 		$ch = curl_init($url);
-		
-		if(!ini_get('open_basedir')) {
+
+		if ( ! ini_get('open_basedir'))
+		{
 			curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
 		}
-		
+
 		curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 		curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);
 

src/PHPHtmlParser/CurlInterface.php

@@ -1,8 +1,13 @@
 <?php
 namespace PHPHtmlParser;
 
+/**
+ * Interface CurlInterface
+ *
+ * @package PHPHtmlParser
+ */
 interface CurlInterface {
-	
+
 	/**
 	 * This method should return the content of the url in a string
 	 *