Permalink
Browse files

Add some spec for "is DEPRECATED"

  • Loading branch information...
1 parent c251a84 commit b8106c90cbfa8dbea55404a21f6aacf5bbaeeee8 @lizmat lizmat committed Oct 22, 2013
Showing with 11 additions and 0 deletions.
  1. +11 −0 S02-bits.pod
View
@@ -4956,4 +4956,15 @@ The STD::Regex grammar also adds these:
mod_internal:sym<P5> m:/ ... :P5 ... /
quantifier:sym<*> /.*/
+=head1 Deprecations
+
+A language that doesn't evolve, is a dead language. Constructs that
+seem like a good idea now, may turn out not to be such a good idea in the
+future. Such constructs will thus need to be deprecated. To mark a construct
+as being deprecated, one can add the "is DEPRECATED($alternative)" trait to
+a class, an attribute, or a sub / method. During execution, this will cause
+the caller sites to be recorded without any warnings. When execution finishes,
+a report should be printed to STDERR stating which deprecated features where
+called where.
+
=for vim:set expandtab sw=4:

0 comments on commit b8106c9

Please sign in to comment.