add multi key support

fixes #2287
can you point me to the doco on how to do this?