API listing for return types

[krlmlr]

Perhaps by looking up the function's documentation and fetching the \value{} section. This might make the listings much longer and introduce more false positives (documentation edits that don't change the semantics).

https://github.com/hadley/dplyr/pull/2384#issuecomment-275664943

CC @hadley.