Author: rgrjr
Date: Fri Apr 4 17:18:59 2008
New Revision: 26751
Modified:
trunk/docs/pdds/draft/pdd06_pasm.pod
trunk/docs/pdds/pdd23_exceptions.pod
Changes in other areas also in this revision:
Modified:
trunk/docs/compiler_faq.pod
trunk/docs/pmc/subs.pod
Log:
* docs/compiler_faq.pod:
+ Update the NS deletion example.
+ Replace find_global with get_(hll|root)_global.
* docs/pmc/subs.pod:
+ Ditto. This could use a good deal more updating -- some of the
examples use very old calling conventions -- but I'm not sure how
to do this without changing PASM to PIR.
* docs/pdds/pdd23_exceptions.pod:
* docs/pdds/draft/pdd06_pasm.pod:
+ Ditto.
Modified: trunk/docs/pdds/draft/pdd06_pasm.pod
==============================================================================
--- trunk/docs/pdds/draft/pdd06_pasm.pod (original)
+++ trunk/docs/pdds/draft/pdd06_pasm.pod Fri Apr 4 17:18:59 2008
@@ -610,10 +610,14 @@
Find the PMC for the global variable sy from the table sz and store it in
register X
+{{ DEPRECATED: op find_global was deprecated }}
+
=item find_global Px, sy
Find the PMC for the global in the default table and put it in X.
+{{ DEPRECATED: op find_global was deprecated }}
+
=item find_global_table Px, sy
Find the global symbol table Y and store its PMC in X
@@ -631,6 +635,8 @@
Store X in the default global symbol table with a name of Y.
+{{ DEPRECATED: op store_global was deprecated }}
+
=back
=head2 Exceptions
Modified: trunk/docs/pdds/pdd23_exceptions.pod
==============================================================================
--- trunk/docs/pdds/pdd23_exceptions.pod (original)
+++ trunk/docs/pdds/pdd23_exceptions.pod Fri Apr 4 17:18:59 2008
@@ -352,7 +352,8 @@
general categories of opcodes that should throw exceptions. }}
Other opcodes respond to an C<errorson> setting to decide whether to
-throw an exception or return an error value. C<find_global> throws an
+throw an exception or return an error value. C<get_hll_global> and
+C<get_root_global> throw an
exception (or returns a Null PMC) if the global name requested doesn't
exist. C<find_name> throws an exception (or returns a Null PMC) if the
name requested doesn't exist in a lexical, current, global, or built-in
@@ -401,7 +402,7 @@
=head2 Resuming after Exceptions
Exceptions thrown by standard Parrot opcodes (like the one thrown by
-C<find_global> above or by the C<throw> opcode) are always resumable,
+C<get_hll_global> above or by the C<throw> opcode) are always resumable,
so when the exception handler function returns normally it continues
execution at the opcode immediately after the one that threw the
exception. Other exceptions at the run-loop level are also generally
