[perl #46593] [PATCH] better documentation on parameter passing

[James Keenan via RT]

Can someone more familiar than I am with C header files take a look at
this patch?  Thank you very much.