support dot for references file and update docs