Fix various DocBlocks

Document.php

@@ -69,7 +69,7 @@ class Document
      *
      *   - <em>base</em>     The base IRI of the input document.
      *
-     * @param string|array|object $input The JSON-LD document to process.
+     * @param string|array|object $document The JSON-LD document to process.
      * @param null|array|object $options Options to configure the processing.
      *
      * @return Document The parsed JSON-LD document.

Exception/ParseException.php

@@ -18,9 +18,21 @@
  */
 class ParseException extends \RuntimeException
 {
+    /**
+     * The file being parsed
+     *
+     * @var string
+     */
     private $parsedFile;
+
+    /**
+     * The raw error message (containing place-holders)
+     *
+     * @var string
+     */
     private $rawMessage;
 
+
     /**
      * Constructor.
      *

Exception/ProcessException.php

@@ -21,10 +21,28 @@
  */
 class ProcessException extends \RuntimeException
 {
+    /**
+     * The file being processed
+     *
+     * @var string
+     */
     private $parsedFile;
+
+    /**
+     * The code snippet that triggered this exception
+     *
+     * @var mixed
+     */
     private $snippet;
+
+    /**
+     * The raw error message (containing place-holders)
+     *
+     * @var string
+     */
     private $rawMessage;
 
+
     /**
      * Constructor.
      *

Exception/SyntaxException.php

@@ -21,10 +21,28 @@
  */
 class SyntaxException extends \RuntimeException
 {
+    /**
+     * The file being parsed
+     *
+     * @var string
+     */
     private $parsedFile;
+
+    /**
+     * The code snippet that triggered this exception
+     *
+     * @var mixed
+     */
     private $snippet;
+
+    /**
+     * The raw error message (containing place-holders)
+     *
+     * @var string
+     */
     private $rawMessage;
 
+
     /**
      * Constructor.
      *

LanguageTaggedString.php

@@ -29,8 +29,8 @@ final class LanguageTaggedString extends Value
     /**
      * Constructor
      *
-     * @param string $value The string's value.
-     * @param string $type The string's language.
+     * @param string $value    The string's value.
+     * @param string $language The string's language.
      */
     public function __construct($value, $language)
     {
@@ -67,11 +67,7 @@ public function getLanguage()
     }
 
     /**
-     * Compares this language-tagged string object to the specified value.
-     *
-     * @param mixed $value
-     * @return bool Returns true if the passed value is the same as this
-     *              instance; false otherwise.
+     * {@inheritdoc}
      */
     public function equals($other)
     {

NQuads.php

@@ -21,7 +21,7 @@
 class NQuads implements QuadSerializer
 {
     /**
-     * {@inheritDoc}
+     * {@inheritdoc}
      */
     public function serialize(array $quads)
     {

Node.php

@@ -473,7 +473,7 @@ public function getReverseProperty($property)
     /**
      * Compares this Node object to the specified value.
      *
-     * @param mixed $value
+     * @param mixed $other The value this instance should be compared to.
      * @return bool Returns true if the passed value is the same as this
      *              instance; false otherwise.
      */

Processor.php

@@ -697,8 +697,6 @@ private function expandIri($value, $activectx, $relativeIri = false, $vocabRelat
      * @param mixed  $element    A JSON-LD element to be compacted.
      * @param array  $activectx  The active context.
      * @param string $activeprty The active property.
-     * @param bool   $optimize   If set to true, the JSON-LD processor is allowed optimize
-     *                           the passed context to produce even compacter representations.
      *
      * @return mixed The compacted JSON-LD document.
      */
@@ -2312,7 +2310,7 @@ private static function mergeIntoProperty(&$object, $property, $value, $alwaysAr
      * are compared lexicographically.
      *
      * @param mixed $a Value A.
-     * @param mixed $a Value B.
+     * @param mixed $b Value B.
      *
      * @return int If value A is shorter than value B, -1 will be returned; if it's
      *             longer 1 will be returned. If both values have the same lenght

QuadSerializer.php

@@ -21,7 +21,7 @@ interface QuadSerializer
     /**
      * Serializes quads to a string.
      *
-     * @param array $quads Array of {@link Quad Quads} to be serialized
+     * @param Quad[] $quads Array of quads to be serialized.
      *
      * @return string The serialized quads.
      */

Test/DocumentTest.php

@@ -24,6 +24,11 @@
  */
 class DocumentTest extends \PHPUnit_Framework_TestCase
 {
+    /**
+     * The document instance being used throughout the tests.
+     *
+     * @var Document
+     */
     protected $document;
 
     /**

Test/JsonLDTestSuiteTest.php

@@ -28,6 +28,13 @@ class JsonLDTestSuiteTest extends \PHPUnit_Framework_TestCase
     private $basedir;
 
 
+    /**
+     * Constructs a test case with the given name.
+     *
+     * @param  string $name
+     * @param  array  $data
+     * @param  string $dataName
+     */
     public function __construct($name = null, array $data = array(), $dataName = '')
     {
         parent::__construct($name, $data, $dataName);

TypedValue.php

@@ -74,11 +74,7 @@ public function getType()
     }
 
     /**
-     * Compares this Value object to the specified value.
-     *
-     * @param mixed $value
-     * @return bool Returns true if the passed value is the same as this
-     *              instance; false otherwise.
+     * {@inheritdoc}
      */
     public function equals($other)
     {

Value.php

@@ -32,7 +32,7 @@ abstract class Value
      * If the passed value element can't be transformed to a language-tagged
      * string or a typed value null is returned.
      *
-     * @param object $element The JSON-LD element
+     * @param \stdClass $element The JSON-LD element
      *
      * @return null|LanguageTaggedString|TypedValue The parsed object
      */
@@ -111,9 +111,9 @@ public function getValue()
     }
 
     /**
-     * Compares this Value object to the specified value.
+     * Compares this instance to the specified value.
      *
-     * @param mixed $value
+     * @param mixed $other The value this instance should be compared to.
      * @return bool Returns true if the passed value is the same as this
      *              instance; false otherwise.
      */