javadoc: clearing behaviour on syncs
Merge pull request #1131 from clebertsuconic/master

just clearing the sync behaviour and adding some doc