Merge pull request #21 from lukeify/docs/phpdoc-throws

Add @throws tags to the public API

Author: colinodell

src/Json5Decoder.php

@@ -66,6 +66,8 @@ private function __construct($json, $associative = false, $depth = 512, $castBig
      * @param int    $depth       User specified recursion depth.
      * @param int    $options     Bitmask of JSON decode options.
      *
+     * @throws SyntaxError if the JSON encoded string could not be parsed.
+     *
      * @return mixed
      */
     public static function decode($source, $associative = false, $depth = 512, $options = 0)

src/global.php

@@ -13,6 +13,8 @@
      * @param int    $depth       User specified recursion depth.
      * @param int    $options     Bitmask of JSON decode options.
      *
+     * @throws \ColinODell\Json5\SyntaxError if the JSON encoded string could not be parsed.
+     *
      * @return mixed
      */
     function json5_decode($source, $associative = false, $depth = 512, $options = 0)