please doxygen document the new boolean flag