[svn:parrot] r36989 - trunk
coke at svn.parrot.org
coke at svn.parrot.org
Wed Feb 25 05:04:55 UTC 2009
Author: coke
Date: Wed Feb 25 05:04:54 2009
New Revision: 36989
URL: https://trac.parrot.org/parrot/changeset/36989
Log:
[docs] Eliminate some developer-specific verbiage; this is meant to be our user-facing deprecation notice.
Modified:
trunk/DEPRECATED.pod
Modified: trunk/DEPRECATED.pod
==============================================================================
--- trunk/DEPRECATED.pod Wed Feb 25 04:23:40 2009 (r36988)
+++ trunk/DEPRECATED.pod Wed Feb 25 05:04:54 2009 (r36989)
@@ -6,21 +6,20 @@
has an associated Trac ticket [1]. Each item indicates the last release it's
guaranteed to appear in.
-When deprecated items are removed, all usage of the feature in the
-repository should be updated or removed, including documentation.
+Please see L<docs/project/support_policy.pod> for the parrot
+project's policy regarding deprecated features.
-When deprecating opcodes, in addition to the ticket, be sure to mark the
-opcode with the :deprecated flag; this will allow users to enable deprecation
-warnings selectively with:
+Following the 1.0 release, whenever deprecated items are removed, information
+regarding how to cope with the removal will be added to
+L<https://trac.parrot.org/parrot/wiki/Deprecation>.
+
+When running parrot, you can receive warnings about deprecated opcodes.
+Either run parrot with the C<-w> option to enable all warnings, or
+specifically by including this C<PIR> code:
.include 'include/warnings.pasm'
warningson .PARROT_WARNINGS_DEPRECATED_FLAG
-And then receive runtime warnings if they are using any deprecated opcodes.
-The C<-w> command line option for parrot can also be used to enable all
-warnings. You can use C<make warnings_tests> to run the standard test suite
-with this option.
-
=head1 Command line options
=over 4
More information about the parrot-commits
mailing list