document the barrel usage