NAME
    Text::Pipe::RandomCase - Text::Pipe filter to randomize character case

SYNOPSIS
       use Text::Pipe qw(PIPE);
       print PIPE('RandomCase')->filter('foobar');
       print PIPE('RandomCase', probability => 2 )->filter('foobar');

DESCRIPTION
    This module provides a pipe segment for Text::Pipe to randomly uppercase
    the characters of a string. It takes one optional argument named
    *probatility*, which determines the frequency of upper case characters.
    Any 1/N'th character will be uppercased on average.

    If you do not pass any arguments, *filter()* will return strings with a
    probability of 1/4 for any character to be uppercased.

DEPENDENCIES
    Text::Pipe

VERSION
    0.01

AUTHOR
    Mario Domgoergen <mdom@cpan.org>

BUGS
    Please report any bugs or feature requests to "bug-text-pipe-randomcase
    at rt.cpan.org", or through the web interface at
    <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Text-Pipe-RandomCase>. I
    will be notified, and then you'll automatically be notified of progress
    on your bug as I make changes.

SUPPORT
    You can find documentation for this module with the perldoc command.

        perldoc Text::Pipe::RandomCase

    You can also look for information at:

    * RT: CPAN's request tracker
        <http://rt.cpan.org/NoAuth/Bugs.html?Dist=Text-Pipe-RandomCase>

    * AnnoCPAN: Annotated CPAN documentation
        <http://annocpan.org/dist/Text-Pipe-RandomCase>

    * CPAN Ratings
        <http://cpanratings.perl.org/d/Text-Pipe-RandomCase>

    * Search CPAN
        <http://search.cpan.org/dist/Text-Pipe-RandomCase>

LICENSE AND COPYRIGHT
    Copyright 2008-2009 Mario Domgoergen.

    This program is free software; you can redistribute it and/or modify it
    under the terms the GNU General Public License as published by the Free
    Software Foundation; either version 1, or (at your option) any later
    version.