ENH: add a note clarifying the functionality