Hopefully fix #1384

Can @madmaxoft comment?
Remaining part of fix.
Fixed line left in.
Typo fix.
Fixed typo again.
Fixed return value descriptions.
Copy edit.
changed description to be more readable.
Add Code example.
Merge pull request #1463 from mc-server/sp_docs

Add docs for HOOK_SERVER_PING