Improve documentation for nextcallee

[wayland]

The problem

nextcallee was not explained in terms of a) whether it needed parameters, and b) whether it ever returned.

Solution provided

• Answered both those questions
• Provided a handy table of the call/next same/with tools