Note as requested

Just documents the feature.  Will take a shot at doxygen-ing it
tomorrow.