René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"dgram `socket.send()` documentation needs clarification","articleBody":"In [the version of the `dgram` doc that is current as of this writing](https://github.com/nodejs/node/blob/6e3bccbc03ffbdf0420f4802b5d992bc27bc5b0f/doc/api/dgram.markdown), the first argument (`buf`) is described initially as:\n\n\u003e Buffer object, string, or an array of either. Message to be sent.\n\nHowever, it is subsequently described as a Buffer object only:\n\n\u003e The `buf` argument is a [`Buffer`] object containing the message. The `offset`\n\u003e and `length` specify the offset within the `Buffer` where the message begins\n\u003e and the number of bytes in the message, respectively. With messages that\n\u003e contain  multi-byte characters, `offset` and `length` will be calculated with\n\u003e respect to [byte length][] and not the character position.\n\nAdditionally, it is not clear what `offset` and `length` mean when the `buf` argument is an array. It's also not clear if the multi-byte caveat applies if `buf` is a string or only if `buf` is a Buffer object.\n\nIt may be worth changing the name from `buf` to `msg` or something like that.\n\n/cc @nodejs/documentation \n","author":{"url":"https://github.com/Trott","@type":"Person","name":"Trott"},"datePublished":"2016-02-06T21:25:06.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":6},"url":"https://github.com/5124/node/issues/5124"}