Better support for @return and @throws

[n-peugnet]

• Correctly parse Type and optional description components. See https://docs.phpdoc.org/latest/guide/references/phpdoc/tags/throws.html and https://docs.phpdoc.org/latest/guide/references/phpdoc/tags/return.html
• Better rST rendering by outputting throws type and rtype field

Example

	/**
	 * Parse a readable stream into an indexed :php:class:`SphinxInventory` object.
	 *
	 * @param resource	$stream		The resource to parse, opened in read mode.
	 * @param string	$baseURI	The base string to prepend to an object's location to get its final URI.
	 *
	 * @return SphinxInventory		The inventory parsed from the stream.
	 * @throws UnexpectedValueException	If an unexpected value is encountered while parsing.
	 */

Before:

After:

JSON diff:

--- before.json	2023-04-04 14:49:01.314363680 +0200
+++ after.json	2023-04-04 14:49:24.822424985 +0200
@@ -47,20 +47,18 @@
       {
         "type": "return",
         "types": [
           "SphinxInventory"
         ],
-        "name": "he",
-        "description": "inventory parsed from the stream."
+        "description": "The inventory parsed from the stream."
       },
       {
         "type": "throws",
         "types": [
           "UnexpectedValueException"
         ],
-        "name": "f",
-        "description": "an unexpected value is encountered while parsing."
+        "description": "If an unexpected value is encountered while parsing."
       }
     ],
     "description": "Parse a readable stream into an indexed :php:class:`SphinxInventory` object.",
     "isPrivate": false,
     "isProtected": false,