Full function signature in rST (functions & methods)

[n-peugnet]

The only part we need to strip from the signature is the 'function' one, sphinxcontrib-phpdomains handles pretty well the rest of the signature.
This adds a lot more details to the docs, by showing where the parameters are, their default values and the optional return value Type hint.

This also allows to visually differentiate instance methods from class
methods.

Example

class SphinxInventoryParser {

	/**
	 * 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.
	 */
	public function parse($stream, string $baseURI = ''): SphinxInventory {

Before:

After: