Fixes issue #1252. Add test case for #1252. Update docs accordingly. Refs #1252. Correct return value from test_pool_alloc.cpp.