Add return type hints.

Author: linclark

src/MicrodataPhp.php

@@ -61,7 +61,7 @@ public function __construct($config) {
   /**
    * Retrieve microdata as a PHP object.
    *
-   * @return
+   * @return object
    *   An object with an 'items' property, which is an array of top level
    *   microdata items as objects with the following properties:
    *   - type: An array of itemtype(s) for the item, if specified.
@@ -86,7 +86,7 @@ public function obj() {
   /**
    * Retrieve microdata in JSON format.
    *
-   * @return
+   * @return string
    *   See obj().
    *
    * @todo MicrodataJS allows callers to pass in a function to format the JSON.

src/MicrodataPhpDOMDocument.php

@@ -9,7 +9,7 @@ class MicrodataPhpDOMDocument extends \DOMDocument {
   /**
    * Retrieves a list of microdata items.
    *
-   * @return
+   * @return DOMNodeList
    *   A DOMNodeList containing all top level microdata items.
    *
    * @todo Allow restriction by type string.
@@ -22,7 +22,7 @@ public function getItems() {
   /**
    * Creates a DOMXPath to query this document.
    *
-   * @return
+   * @return DOMXPath
    *   DOMXPath object.
    */
   public function xpath() {

src/MicrodataPhpDOMElement.php

@@ -10,8 +10,8 @@ class MicrodataPhpDOMElement extends \DOMElement {
   /**
    * Determine whether the itemscope attribute is present on this element.
    *
-   * @return
-   *   boolean TRUE if this is an item, FALSE if it is not.
+   * @return bool
+   *   TRUE if this is an item, FALSE if it is not.
    */
   public function itemScope() {
     return $this->hasAttribute('itemscope');
@@ -20,7 +20,7 @@ public function itemScope() {
   /**
    * Retrieve this item's itemtypes.
    *
-   * @return
+   * @return array
    *   An array of itemtype tokens.
    */
   public function itemType() {
@@ -36,7 +36,7 @@ public function itemType() {
   /**
    * Retrieve this item's itemid.
    *
-   * @return
+   * @return string
    *   A string with the itemid.
    */
   public function itemId() {
@@ -52,7 +52,7 @@ public function itemId() {
   /**
    * Retrieve this item's itemprops.
    *
-   * @return
+   * @return array
    *   An array of itemprop tokens.
    */
   public function itemProp() {
@@ -66,7 +66,7 @@ public function itemProp() {
   /**
    * Retrieve the ids of other items which this item references.
    *
-   * @return
+   * @return array
    *   An array of ids as contained in the itemref attribute.
    */
   public function itemRef() {
@@ -80,7 +80,7 @@ public function itemRef() {
   /**
    * Retrieve the properties
    *
-   * @return
+   * @return array
    *   An array of MicrodataPhpDOMElements which are properties of this
    *   element.
    */
@@ -107,7 +107,7 @@ public function properties() {
   /**
    * Retrieve the element's value, determined by the element type.
    *
-   * @return
+   * @return string
    *   The string value if the element is not an item, or $this if it is
    *   an item.
    */