document CLI behavior