added some compatibility notes