DOC: document the behavior in #2542