add note to docstring

re #457