tweak docs about sync functions