add ~b documentation