Formally deprecate the whole thing

[perl/modules/with.git] / lib / with.pm

diff --git a/lib/with.pm b/lib/with.pm
index 2a086f5f6d287b9edef4a48b928420cb6226a37a..965e6da442f32ca51f60047967b943521959c596 100644 (file)
--- a/lib/with.pm
+++ b/lib/with.pm
@@ -5,12 +5,12 @@ use 5.009_004;
 use strict;
 use warnings;
 
-use Carp qw/croak/;
+use Carp           qw<croak>;
 use Filter::Util::Call;
-use Text::Balanced qw/extract_variable extract_quotelike extract_multiple/;
-use Scalar::Util qw/refaddr set_prototype/;
+use Text::Balanced qw<extract_variable extract_quotelike extract_multiple>;
+use Scalar::Util   qw<refaddr set_prototype>;
 
-use Sub::Prototype::Util qw/flatten wrap/;
+use Sub::Prototype::Util qw<flatten wrap>;
 
 =head1 NAME
 
@@ -24,6 +24,12 @@ Version 0.02
 
 our $VERSION = '0.02';
 
+=head1 WARNING
+
+This module was an early experiment which turned out to be completely unpractical.
+Therefore its use is officially B<deprecated>.
+Please don't use it, and don't hesitate to contact me if you want to reuse the namespace.
+
 =head1 SYNOPSIS
 
     package Deuce;
@@ -96,15 +102,15 @@ my $extractor = [
 ];
 
 my %skip;
-$skip{$_} = 1 for qw/my our local sub do eval goto return
+$skip{$_} = 1 for qw<my our local sub do eval goto return
                      if else elsif unless given when or and
                      while until for foreach next redo last continue
                      eq ne lt gt le ge cmp
                      map grep system exec sort print say
                      new
-                     STDIN STDOUT STDERR/;
+                     STDIN STDOUT STDERR>;
 
-my @core = qw/abs accept alarm atan2 bind binmode bless caller chdir chmod
+my @core = qw<abs accept alarm atan2 bind binmode bless caller chdir chmod
               chomp chop chown chr chroot close closedir connect cos crypt
               dbmclose dbmopen defined delete die do dump each endgrent
               endhostent endnetent endprotoent endpwent endservent eof eval
@@ -127,7 +133,7 @@ my @core = qw/abs accept alarm atan2 bind binmode bless caller chdir chmod
               sqrt srand stat study sub substr symlink syscall sysopen sysread
               sysseek system syswrite tell telldir tie tied time times
               truncate uc ucfirst umask undef unlink unpack unshift untie use
-              utime values vec wait waitpid wantarray warn write/;
+              utime values vec wait waitpid wantarray warn write>;
 
 my %core;
 $core{$_} = prototype "CORE::$_" for @core;