Devel::Autoflush(3)

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>

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>

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.