improve the documentation about the Bool parameter of snapshot