add more parameter to connection pool and documentation

This is the backport on the 11.x branch of https://github.com/geotools/geotools/pull/501