Improve documentation for pool and maxSockets options

This has come up several times recently, for example #1150 and #1249.
Merge pull request #1250 from nylen/document-pool-maxSockets

Improve documentation for pool and maxSockets options