move flag handling into guttered.go
docs and error messages