add more documentation to connection pool parameters

more doc after adding more parameter in the connection pool. See geotools pull req https://github.com/geotools/geotools/pull/501