@node CGI/Out, CGI/Request, CGI/MiniSvr, Module List
@unnumbered buffer output when building CGI programs


@unnumberedsec NAME

CGI::Out - buffer output when building CGI programs

@unnumberedsec SYNOPSIS

@example
use CGI;
use CGI::Out;
@end example

@example
$query = new CGI;
savequery $query;		# to reconstruct input
@end example

@example
$CGI::Out::mailto = @'fred@';	# override default of $<
@end example

@example
out $query->header();
out $query->start_html(
	-title=>@'A test@',
	-author=>@'muir@@idiom.com@');
@end example

@example
croak "We@'re outta here!";
confess "It was my fault: $!";
carp "It was your fault!";
warn "I@'m confused";
die  "I@'m dying.\n";
@end example

@example
use CGI::Out qw(carpout);
carpout(\*LOG);
@end example

@unnumberedsec DESCRIPTION

This is a helper routine for building CGI programs.  It buffers
stdout until you@'re completed building your output.  If you should
get an error before you are finished, then it will display a nice
error message (in HTML), log the error, and send email about the
problem.

It wraps all of the functions provided by CGI::Carp and Carp.  Do
not "use" them directly, instead just "use CGI::Out".

Instead of print, use @code{out}.

@unnumberedsec AUTHOR

David Muir Sharnoff <muir@@idiom.com>

@unnumberedsec SEE ALSO

Carp, CGI::Carp, CGI, CGI::Wrap

@unnumberedsec BUGS

No support for formats is provided by CGI::Out.

