Author: jonathan
Date: Mon Nov 24 14:49:30 2008
New Revision: 33162
Modified:
trunk/docs/pdds/pdd23_exceptions.pod
Log:
[pdd] Add details of how to get bytecode annotations from Exception PMC.
Modified: trunk/docs/pdds/pdd23_exceptions.pod
==============================================================================
--- trunk/docs/pdds/pdd23_exceptions.pod (original)
+++ trunk/docs/pdds/pdd23_exceptions.pod Mon Nov 24 14:49:30 2008
@@ -199,6 +199,18 @@
Set an attribute on the Exception. All exceptions will have at least
C<message>, C<severity>, and C<payload> attributes.
+=item B<PMC *annotations()>
+
+Gets a Hash containing any bytecode annotations in effect at the point where
+the exception was thrown. If none were in effect, returns an empty Hash. See
+the PIR PDD for syntax for declaring and semantics of bytecode annotations.
+
+=item B<PMC *annotation(STRING *name)>
+
+Returns a PMC representing the bytecode annotation with the key specified in
+C<name> at the point where the exception was thrown. If there was no such
+annotation in effect, a NULL PMC will be returned.
+
=back
=head2 Standard Parrot Exceptions
lmpx.com only provides a reader for public news (NNTP) servers. It is not
affiliated with the servers or forums shown here and is not responsible for
the content of articles, which is written by their respective authors.