fix synopsis output
clarify resource use
keep our namespace clean