NAME

       Devel::Autoflush - Set autoflush from the command line

VERSION

       This documentation describes version 0.05.

SYNOPSIS

         perl -MDevel::Autoflush Makefile.PL

DESCRIPTION

       This module is a hack to set autoflush for STDOUT and STDERR from the command line or from
       "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 "PERL5OPT":

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

BUGS

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

SEE ALSO

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

AUTHOR

       David A. Golden (DAGOLDEN)

COPYRIGHT AND LICENSE

       Copyright (c) 2008-2009 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
       http://www.apache.org/licenses/LICENSE-2.0 <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.