Documentation improvements in buffer markdown

Improvements to document for buffer.toString and buffer.copy per issues
#8859 and #8857

(rebased and on joyent/v0.10 and improved slightly)