issue #810: documented immutability of returned objects