Fixed phpdoc

Author: GrahamCampbell

src/Dotenv.php

@@ -3,9 +3,10 @@
 namespace Dotenv;
 
 /**
- * Dotenv.
+ * This is the dotenv class.
  *
- * Loads a `.env` file in the given directory and sets the environment vars.
+ * It's responsible for loading a `.env` file in the given directory and
+ * setting the environment vars.
  */
 class Dotenv
 {

src/Loader.php

@@ -6,11 +6,11 @@
 use Dotenv\Exception\InvalidPathException;
 
 /**
- * Loader.
+ * This is the loaded class.
  *
- * Loads Variables by reading a file from disk and:
- * - stripping comments beginning with a `#`
- * - parsing lines that look shell variable setters, e.g `export key = value`, `key="value"`
+ * It's responsible for loading variables by reading a file from disk and:
+ * - stripping comments beginning with a `#`,
+ * - parsing lines that look shell variable setters, e.g `export key = value`, `key="value"`.
  */
 class Loader
 {
@@ -88,13 +88,13 @@ protected function ensureFileIsReadable()
      * Normalise the given environment variable.
      *
      * Takes value as passed in by developer and:
-     * - ensures we're dealing with a separate name and value, breaking apart the name string if needed
-     * - cleaning the value of quotes
-     * - cleaning the name of quotes
-     * - resolving nested variables
+     * - ensures we're dealing with a separate name and value, breaking apart the name string if needed,
+     * - cleaning the value of quotes,
+     * - cleaning the name of quotes,
+     * - resolving nested variables.
      *
-     * @param $name
-     * @param $value
+     * @param string $name
+     * @param string $value
      *
      * @return array
      */
@@ -245,7 +245,7 @@ protected function sanitiseVariableValue($name, $value)
      * Look for {$varname} patterns in the variable value and replace with an existing
      * environment variable.
      *
-     * @param $value
+     * @param string $value
      *
      * @return mixed
      */
@@ -321,13 +321,13 @@ public function getEnvironmentVariable($name)
      * Set an environment variable.
      *
      * This is done using:
-     * - putenv
-     * - $_ENV
+     * - putenv,
+     * - $_ENV,
      * - $_SERVER.
      *
      * The environment variable value is stripped of single and double quotes.
      *
-     * @param $name
+     * @param string      $name
      * @param string|null $value
      *
      * @return void
@@ -354,8 +354,8 @@ public function setEnvironmentVariable($name, $value = null)
      * method for 3rd party code.
      *
      * This is done using:
-     * - putenv
-     * - unset($_ENV, $_SERVER)
+     * - putenv,
+     * - unset($_ENV, $_SERVER).
      *
      * @param string $name
      *

src/Validator.php

@@ -6,9 +6,9 @@
 use Dotenv\Exception\InvalidPathException;
 
 /**
- * Validator.
+ * This is the validator class.
  *
- * Validations to be applied against a number of variables.
+ * It's responsible for applying validations against a number of variables.
  */
 class Validator
 {