Using `ulimit -n` to set the limit much higher than the default of 256 in Darwin seems to avoid the `EMFILE` error that was plaguing our Mac developers.
This directory contains some high level documentation for the code. WARNING: much of this is out-of-date. It stil may be helpful, though.