some requests for clarification from Deuce.

bugs.

This part of the change didn't really make much sense and becomes silly
for "external" sockets.

using is_connected for get checks rather than special casing external.

js_CreateSocketObject() and don't care what p->is_connected is when p->external
is true.

such that the local address will return a valid value as long as the
socket is not known to be invalid and the remote address will return
a value as long as it was connected last time we looked.

This should help avoid unexcpected behaviour on a SYN+FIN which would
results in is_connected being true, but remote_id_address being undefined.

can crash SpiderMonkey as it tries to report the error.

NOTE: js_sendfile() should be using the xpdev socksendfile() function...
      The way it's currently working is just plain insanity.

0 = linger disabled (no time-out value)
non-zero = time-out value (in seconds), linger enabled

Updated JS docs for methods.

(rather than _DEBUG) - improving performance and memory usage in the 99% of
debug builds that don't need the JSDOC stuff.

platform and socket type combination.

Moved getSocketOptionByName() to xpdev/sockwrap module.

(replacing sockopts.cfg).

(ASCII 0) to be read from or written to sockets and files.

valid).

initialized as such by the caller).

(which requires #inclusion of private jsobj.h header file) in js_socket().
To get the correct prototype for JS_GetClass, JS_THREADSAFE must be defined
(next commit).

to support >30-bit integers (e.g. current time_t values).

(i.e. not a socket object).

value (returns INVALID_SOCKET).

strict-aliasing rules.

interface address argument was specified.

particular network interface to bind to (e.g. server.interface_ip_address).

(whenever possible), for documentation purposes (jsdocs.js).

parameter values.
Created js_timeval() function for converting numeric jsargs to struct timeval.

global socket_select() and Socket.poll() methods.