Add docs for pool.go
Merge pull request #53 from gsalgado/vp-doc

Add docs for pool.go
Add doc comments to internal_test.go
Also move two tests from internal_test.go to pool_test.go (actual tests should not be placed in internal_test.go).