# Generated by Pod::WikiDoc version 0.18

=pod

=head1 NAME

Devel::Autoflush - Set autoflush from the command line

=head1 VERSION

This documentation describes version 0.04.

=head1 SYNOPSIS

  perl -MDevel::Autoflush Makefile.PL

=head1 DESCRIPTION

This module is a hack to set autoflush for STDOUT and STDERR from the command
line or from C<<< PERL5OPT >>> for code that needs it but doesn't have it.

This often happens when prompting:

   # guess.pl
   print "Guess a number: ";
   my $n = <STDIN>;

As long as the output is going to a terminal, the prompt is flushed when STDIN
is read.  However, if the output is being piped, the print statement will 
not automatically be flushed, no prompt will be seen and the program will
silently appear to hang while waiting for input.  This might happen with 'tee':

   $ perl guess.pl | tee capture.out

Use Devel::Autoflush to work around this:

   $ perl -MDevel::Autoflush guess.pl | tee capture.out

Or set it in C<<< PERL5OPT >>>:

   $ export PERL5OPT=-MDevel::Autoflush
   $ perl guess.pl | tee capture.out

=head1 BUGS

Please report any bugs or feature using the CPAN Request Tracker.  
Bugs can be submitted through the web interface at 
L<http://rt.cpan.org/Dist/Display.html?Queue=Devel-Autoflush>

When submitting a bug or request, please include a test-file or a patch to an
existing test-file that illustrates the bug or desired feature.

=head1 SEE ALSO

=over

=item *

L<CPANPLUS::Internals::Utils::Autoflush> -- same idea but STDOUT only and 
only available as part of the full CPANPLUS distribution

=back

=head1 AUTHOR

David A. Golden (DAGOLDEN)

=head1 COPYRIGHT AND LICENSE

Copyright (c) 2008 by David A. Golden

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at 
L<http://www.apache.org/licenses/LICENSE-2.0>

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.


