core: note backwards incompat in code