Merge remote-tracking branch 'ry/v0.10'
authorisaacs <i@izs.me>
Fri, 8 Nov 2013 21:41:44 +0000 (13:41 -0800)
committerisaacs <i@izs.me>
Fri, 8 Nov 2013 21:41:44 +0000 (13:41 -0800)
1  2 
doc/api/crypto.markdown
doc/api/dgram.markdown
doc/api/process.markdown

Simple merge
@@@ -74,30 -69,29 +74,34 @@@ Emitted when an error occurs
  
  ### socket.send(buf, offset, length, port, address, [callback])
  
 -* `buf` Buffer object.  Message to be sent
 +* `buf` Buffer object or string.  Message to be sent
  * `offset` Integer. Offset in the buffer where the message starts.
  * `length` Integer. Number of bytes in the message.
- * `port` Integer. destination port
- * `address` String. destination IP
- * `callback` Function. Callback when message is done being delivered.
-   Optional.
- For UDP sockets, the destination port and IP address must be specified.  A string
- may be supplied for the `address` parameter, and it will be resolved with DNS.  An
- optional callback may be specified to detect any DNS errors and when `buf` may be
- re-used.  Note that DNS lookups will delay the time that a send takes place, at
- least until the next tick.  The only way to know for sure that a send has taken place
- is to use the callback.
- If the socket has not been previously bound with a call to `bind`, it's
- assigned a random port number and bound to the "all interfaces" address
- (0.0.0.0 for `udp4` sockets, ::0 for `udp6` sockets).
+ * `port` Integer. Destination port.
+ * `address` String. Destination hostname or IP address.
+ * `callback` Function. Called when the message has been sent. Optional.
+ For UDP sockets, the destination port and address must be specified.  A string
+ may be supplied for the `address` parameter, and it will be resolved with DNS.
+ If the address is omitted or is an empty string, `'0.0.0.0'` or `'::0'` is used
+ instead.  Depending on the network configuration, those defaults may or may not
+ work; it's best to be explicit about the destination address.
+ If the socket has not been previously bound with a call to `bind`, it gets
+ assigned a random port number and is bound to the "all interfaces" address
+ (`'0.0.0.0'` for `udp4` sockets, `'::0'` for `udp6` sockets.)
+ An optional callback may be specified to detect DNS errors or for determining
+ when it's safe to reuse the `buf` object.  Note that DNS lookups delay the time
+ to send for at least one tick.  The only way to know for sure that the datagram
+ has been sent is by using a callback.
  
 +With consideration for multi-byte characters, `offset` and `length` will
 +be calculated with respect to
 +[byte length](buffer.html#buffer_class_method_buffer_bytelength_string_encoding)
 +and not the character position.
 +
  Example of sending a UDP packet to a random port on `localhost`;
  
      var dgram = require('dgram');
Simple merge