can you doxygen document the interface to this method?