provide an interface to access generated output more as a stream

`croak` is a `die` that can print a stack trace (see perldoc for Carp). If you prefer it, make the example do something nicer. I just need an example of how to use it in the POD.