=BG= document new sample usage