view release on metacpan or  search on metacpan

lib/Alt/IO/All/new.pod  view on Meta::CPAN

=pod

=for comment
DO NOT EDIT. This Pod was generated by Swim.
See http://github.com/ingydotnet/swim-pm#readme

=encoding utf8

=head1 NAME

Alt::IO::All::new - Alternate IO::All - The Rewrite

=for html
<a href="https://travis-ci.org/ingydotnet/alt-io-all-new-pm"><img src="https://travis-ci.org/ingydotnet/alt-io-all-new-pm.png" alt="alt-io-all-new-pm"></a>
<a href="https://coveralls.io/r/ingydotnet/alt-io-all-new-pm?branch=master"><img src="https://coveralls.io/repos/ingydotnet/alt-io-all-new-pm/badge.png" alt="alt-io-all-new-pm"></a>

=head1 SYNOPSIS

    > cpanm Alt::IO::All::new

    use IO::All;

=head1 DESCRIPTION

This is a rewrite of the infamous L<IO::All>. The new design is
detailed below.

=head1 STATUS

This is a very early release. It's just barely operational. Enough to upload
to CPAN under the new experimental C<Alt-> namespace.

=head1 C<IO::ALL> DESIGN

This is a design document for an upcoming version of IO::All.

IO::All is a Perl module that attempts to make all Input/Output operations in
Perl, as simple and normal as possible. IO::All has been in existence since
2005. It is useful and somewhat extensible, but has a number of
inconsistencies, flaws and misgivings.

This document will propose a better way to do it, and will also discuss how to
move the current API forward to the new API.

=head1 BASIC PRINCIPLES OF HOW C<IO::ALL> SHOULD WORK

=over

=item * IO::All provides a single entry point function called C<io>.

=item * C<use IO::All> should make this function available in a lexical scope.

=over

=item * Currently this scope is 'package' scope.

=item * Would be nice, but maybe not possible to have true lexical scope.

=back

=item * The C<io> function is custom to its scope

=over

=item * The behavior it provides depends on the state of the scope

=item * The behavior it provides also depends on the arguments passed to C<use IO::All>