minor improvements to documentation
use yield for non-error CLI output