refs #552 - added note about __file__ deprecation in 1.1