EZP-22999: improved docblocks a bit