improve doc about order of statements (fix #497)