add javadocs for refresh and sync state methods