document backward compatibility break for future version 1.3