initial import of Text-Demoroniser 0.01 from CPAN

git-cpan-module:   Text-Demoroniser
git-cpan-version:  0.01
git-cpan-authorid: BARBIE
git-cpan-file:     authors/id/B/BA/BARBIE/Text-Demoroniser-0.01.tar.gz

Artistic

@@ -0,0 +1,131 @@
+
+
+
+
+			 The "Artistic License"
+
+				Preamble
+
+The intent of this document is to state the conditions under which a
+Package may be copied, such that the Copyright Holder maintains some
+semblance of artistic control over the development of the package,
+while giving the users of the package the right to use and distribute
+the Package in a more-or-less customary fashion, plus the right to make
+reasonable modifications.
+
+Definitions:
+
+	"Package" refers to the collection of files distributed by the
+	Copyright Holder, and derivatives of that collection of files
+	created through textual modification.
+
+	"Standard Version" refers to such a Package if it has not been
+	modified, or has been modified in accordance with the wishes
+	of the Copyright Holder as specified below.
+
+	"Copyright Holder" is whoever is named in the copyright or
+	copyrights for the package.
+
+	"You" is you, if you're thinking about copying or distributing
+	this Package.
+
+	"Reasonable copying fee" is whatever you can justify on the
+	basis of media cost, duplication charges, time of people involved,
+	and so on.  (You will not be required to justify it to the
+	Copyright Holder, but only to the computing community at large
+	as a market that must bear the fee.)
+
+	"Freely Available" means that no fee is charged for the item
+	itself, though there may be fees involved in handling the item.
+	It also means that recipients of the item may redistribute it
+	under the same conditions they received it.
+
+1. You may make and give away verbatim copies of the source form of the
+Standard Version of this Package without restriction, provided that you
+duplicate all of the original copyright notices and associated disclaimers.
+
+2. You may apply bug fixes, portability fixes and other modifications
+derived from the Public Domain or from the Copyright Holder.  A Package
+modified in such a way shall still be considered the Standard Version.
+
+3. You may otherwise modify your copy of this Package in any way, provided
+that you insert a prominent notice in each changed file stating how and
+when you changed that file, and provided that you do at least ONE of the
+following:
+
+    a) place your modifications in the Public Domain or otherwise make them
+    Freely Available, such as by posting said modifications to Usenet or
+    an equivalent medium, or placing the modifications on a major archive
+    site such as uunet.uu.net, or by allowing the Copyright Holder to include
+    your modifications in the Standard Version of the Package.
+
+    b) use the modified Package only within your corporation or organization.
+
+    c) rename any non-standard executables so the names do not conflict
+    with standard executables, which must also be provided, and provide
+    a separate manual page for each non-standard executable that clearly
+    documents how it differs from the Standard Version.
+
+    d) make other distribution arrangements with the Copyright Holder.
+
+4. You may distribute the programs of this Package in object code or
+executable form, provided that you do at least ONE of the following:
+
+    a) distribute a Standard Version of the executables and library files,
+    together with instructions (in the manual page or equivalent) on where
+    to get the Standard Version.
+
+    b) accompany the distribution with the machine-readable source of
+    the Package with your modifications.
+
+    c) give non-standard executables non-standard names, and clearly
+    document the differences in manual pages (or equivalent), together
+    with instructions on where to get the Standard Version.
+
+    d) make other distribution arrangements with the Copyright Holder.
+
+5. You may charge a reasonable copying fee for any distribution of this
+Package.  You may charge any fee you choose for support of this
+Package.  You may not charge a fee for this Package itself.  However,
+you may distribute this Package in aggregate with other (possibly
+commercial) programs as part of a larger (possibly commercial) software
+distribution provided that you do not advertise this Package as a
+product of your own.  You may embed this Package's interpreter within
+an executable of yours (by linking); this shall be construed as a mere
+form of aggregation, provided that the complete Standard Version of the
+interpreter is so embedded.
+
+6. The scripts and library files supplied as input to or produced as
+output from the programs of this Package do not automatically fall
+under the copyright of this Package, but belong to whoever generated
+them, and may be sold commercially, and may be aggregated with this
+Package.  If such scripts or library files are aggregated with this
+Package via the so-called "undump" or "unexec" methods of producing a
+binary executable image, then distribution of such an image shall
+neither be construed as a distribution of this Package nor shall it
+fall under the restrictions of Paragraphs 3 and 4, provided that you do
+not represent such an executable image as a Standard Version of this
+Package.
+
+7. C subroutines (or comparably compiled subroutines in other
+languages) supplied by you and linked into this Package in order to
+emulate subroutines and variables of the language defined by this
+Package shall not be considered part of this Package, but are the
+equivalent of input as in Paragraph 6, provided these subroutines do
+not change the language in any way that would cause it to fail the
+regression tests for the language.
+
+8. Aggregation of this Package with a commercial distribution is always
+permitted provided that the use of this Package is embedded; that is,
+when no overt attempt is made to make this Package's interfaces visible
+to the end user of the commercial distribution.	 Such use shall not be
+construed as a distribution of this Package.
+
+9. The name of the Copyright Holder may not be used to endorse or promote
+products derived from this software without specific prior written permission.
+
+10. THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
+IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+
+				The End

Changes

@@ -0,0 +1,5 @@
+# Changes log for Text::Demoroniser
+
+0.01    11/08/2009
+        - Initial release.
+	- originally inspired by the demoroniser script

INSTALL

@@ -0,0 +1,115 @@
+Installation Instructions
+
+The instructions are basically as per any Perl module.
+
+
+INSTALLING AUTOMATICALLY
+------------------------
+
+The easiest way to install is via CPAN or CPANPLUS:
+
+CPAN:
+
+    % perl -MCPAN -e shell                    [as root]
+    > install Text::Demoroniser
+    > quit
+
+CPANPLUS:
+
+    % cpanp
+    > i Text::Demoroniser
+    > q
+
+See your local 'perldoc CPAN' or 'perldoc CPANPLUS' for
+instructions on setting up and configuring CPAN or CPANPLUS.
+
+
+OBTAINING THE MODULE
+--------------------
+
+The latest release version of Text-Demoroniser can be 
+downloaded from any CPAN site:
+
+    http://www.cpan.org/modules/by-authors/id/B/BA/BARBIE/
+    http://search.cpan.org/dist/Text-Demoroniser/
+
+The module is distributed within a gzipped tar archive file:
+
+    Text-Demoroniser-<version>.tar.gz
+
+where <version> represents the current version number, e.g. 0.01.
+
+To install the module, unpack the distribution archive to
+create an installation directory.  Something like this:
+
+    tar zxf Text-Demoroniser-0.01.tar.gz
+
+or
+
+    gunzip Text-Demoroniser-0.01.tar.gz
+    tar xf Text-Demoroniser-0.01.tar
+
+You can then 'cd' into the directory created,
+
+    cd Text-Demoroniser-0.01
+
+
+INSTALLING MANUALLY
+-------------------
+
+The 'make install' (done later) will install the modules and scripts on
+your system. You may need administrator privileges to perform this task.
+Alternately you can install the module to a local directory (see
+ExtUtils::MakeMaker for full details), e.g.
+
+    % perl Makefile.PL PREFIX=/home/me/
+
+Don't forget to update your PERL5LIB environment variable if you do
+this, or add a line to your script to tell Perl where to find the files,
+e.g.
+
+    use lib qw( /home/me/lib/perl5/site_perl/5.6.0 );
+
+If you're not after a custom location, just do:
+
+    % perl Makefile.PL
+
+If you are lacking any of the prerequisite modules, running that
+program will tell you. All prerequisites are available from CPAN.
+
+When you have them all:
+
+    % make && make test
+
+If there are any failures, it's best if you contact me. It may help
+other people who have the same problem.  I don't tend to read the Perl
+newsgroups or PerlMonks, so it's no use posting there.
+
+When you report your trouble, be sure to send me the following
+information;
+    + result of `perl -V'
+    + output from 'make test' - ideally do 'make test TEST_VERBOSE=1 >& errs'
+
+Send those to bug-Text-Demoroniser@rt.cpan.org and I'll 
+get back to you as soon as I'm able.
+
+If it worked, then become root and type:
+
+    # make install
+
+Congratulations. You've just installed Data::Phrasebook.
+
+If you have a copy of cpantest installed, type:
+
+    % cpantest -g pass -nc -p `basename \`pwd\`` -auto
+
+Or:
+    % cpantest -g pass -nc -p Text-Demoroniser-0.01 -auto
+
+That will tell both me and other potential users that the module
+built correctly on your machine.
+
+Cheers,
+Barbie.
+http://www.missbarbell.co.uk/
+

LICENSE

@@ -0,0 +1,10 @@
+LICENSE FOR Data::FormValidator::Constraints::Words
+
+Copyright � 2008 Barbie for Miss Barbell Productions.
+
+This library is free software; you can redistribute it and/or modify
+it under the same terms as Perl itself.
+
+The full text of the licenses can be found in the Artistic file included with
+this distribution, or in perlartistic file available with your Perl 
+installation.

MANIFEST

@@ -0,0 +1,16 @@
+Artistic
+Changes
+examples/examples.txt
+INSTALL
+lib/Text/Demoroniser.pm
+LICENSE
+Makefile.PL
+MANIFEST			This list of files
+META.yml
+README
+t/01use.t
+t/02examples.t
+t/90podtest.t
+t/91podcover.t
+t/94metatest.t
+t/95changedate.t

META.yml

@@ -0,0 +1,38 @@
+--- #YAML:1.0
+name:                     Text-Demoroniser
+version:                  0.01
+abstract:                 A text filter that allows you to demoronise a string.
+author:
+  - Barbie <barbie@cpan.org>
+
+license:                  perl
+distribution_type:        module
+installdirs:              site
+
+requires:
+  Encode::ZapCP1252:      0
+recommends:
+  Test::More:             0.70
+  Test::Pod:              1.00
+  Test::Pod::Coverage:    0.08
+  Test::CPAN::Meta:       0.13
+build_requires:
+  Test::More:             0.70
+
+provides:
+  Text::Demoroniser:
+    file:     lib/Text/Demoroniser.pm
+    version:  0.01
+no_index:
+  directory:
+    - t
+    - examples
+
+resources:
+  license:    http://dev.perl.org/licenses/
+  bugtracker: http://rt.cpan.org/Public/Dist/Display.html?Name=Text-Demoroniser
+
+meta-spec:
+   version:   1.4
+   url:       http://module-build.sourceforge.net/META-spec-v1.4.html
+generated_by: Hand 1.0

Makefile.PL

@@ -0,0 +1,15 @@
+use ExtUtils::MakeMaker;
+WriteMakefile(
+    'NAME'			=> 'Text::Demoroniser',
+    'VERSION_FROM'	=> 'lib/Text/Demoroniser.pm',
+    'PREREQ_PM'		=> {
+
+        Encode::ZapCP1252   => 0,
+		Test::More	        => 0.70,	# for testing
+	},
+	NO_META			=> 1,
+
+    ($] >= 5.005 ?    ## Add these new keywords supported since 5.005
+      (ABSTRACT	=> 'A text filter that allows you to demoronise a string',
+       AUTHOR	=> 'Barbie <barbie@cpan.org>') : ()),
+);