Cgi::application::plugin::stream provides a way to stream a file back to the user from a cgi::application module. this is useful if you are creating a pdf or spreadsheet document dynamically to deliver to the user. the file is read and printed in small chunks to keep memory consumption down. if you pass along a filehandle it will be automatically closed on completion.