README for babble
=================

Description

Scrambles text in a way that almost, but not quite, makes sense. Feed
it a text file and it will spit out a result that looks like the
original, until you read it and realize it's meandering, senseless
babble.


$ cat alice.txt
The great question certainly was, what? Alice looked all
round her at the flowers and the blades of grass, but she
did not see anything that looked like the right thing to
eat or drink under the circumstances. There was a large
mushroom growing near her, about the same height as
herself; and when she had looked under it, and on both
sides of it, and behind it, it occurred to her that she
might as well look and see what was on the top of it.

She stretched herself up on tiptoe, and peeped over the
edge of the mushroom, and her eyes immediately met those of
a large caterpillar, that was sitting on the top with its
arms folded, quietly smoking a long hookah, and taking not
the smallest notice of her or of anything else.


$ babble alice.txt
The great question certainly was, what? Alice looked all
round her at the flowers and the blades of it.

She stretched herself up on tiptoe, and peeped over the
blades of grass, but she did not see anything that looked
like the right thing to eat or drink under the
circumstances. There was a large mushroom growing near
her, about the same height as herself; and when she did not
see anything that looked like the right thing to eat or
drink under the circumstances. There was a large mushroom
growing near her, about the smallest notice of her or of
it.

She stretched herself up on tiptoe, and taking not the
mushroom, and her eyes immediately met those of grass, but
she did not the smallest notice of her or of anything else.


Installation

sudo gem install babble

Or, on Windows, download and run the installer executable. No Ruby
installation is required for this option.

Usage

babble [filename1 [filename2 ...]]

If no file name is specified, the program will read from STDIN.

Building from Source

The setup should be fairly standard for anyone familiar with Rake.
There are a few external dependencies; see below for links.

Get the source from the project site.

Change into the project directory. Run "rake -T" for a list of
targets. You'll need RubyScript2Exe to build a Windows executable, or
NSIS to build a Windows installer. Building a gem should work out of
the box. "rake" builds an installer and a gem by default.

See Also

Phoenix Ruby Users Group project on RubyForge:
http://rubyforge.org/projects/phoenix/

Phoenix Ruby Users Group homepage: http://rubyaz.org/

Nullsoft Scriptable Install System: http://nsis.sourceforge.net/

RubyScript2Exe: http://www.erikveen.dds.nl/rubyscript2exe/index.html

Author

Copyright Jay McGavren, [email protected]

Licence

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

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
USA

Please see the LICENSE.txt file for the full license.

Thanks

NullSoft Scriptable Install System is used to make the Windows
installer; thanks to its authors.

RubyScript2Exe is used to make the Windows executable; thanks to Erik
Veenstra for pulling off this seemingly impossible feat!