rmccue/WP-Parser — pull request #28 by joncave (2013-08-11 13:23:37+00:00)
Title: Pick up filter docblock by copying it from the assignment node

If filters are documented like this:

/**
* A filter with some exciting documentation
*/
$foo = apply_filters( 'filter', $foo );

then PHP-Parser associates the docblock with the assignment expression
instead of the function call. This means that the documentation isn't
actually retrieved by the hook reflector.

So, tweak the node visitor to check for assignment expressions that have
docblock and a filter as a subnode. The docblock can then be copied to
the subnode.

Required for #26 to work fully. This should just be good to go separately, but I wanted to put the pull request out there whilst I think about the approach and any potential issues.