add a note on usage of the "refresh" attribute