erl_nif doc enhancements

[Steve Vinoski]

This patch enhances the erl_nif documentation for handling resources
to try to make it clearer when and where they can be safely released.
Reviewed by Sverker Eriksson.

git fetch git://github.com/vinoski/otp.git clarify_nif_resource_doc

--steve