[seed] [docs] Add remarks about JavaScriptCore exception model



commit 2074f448e9033a28e5a56757b4a96ebdf929ed30
Author: Robert Carr <racarr gnome org>
Date:   Tue Jul 28 23:55:59 2009 -0400

    [docs] Add remarks about JavaScriptCore exception model

 doc/reference/tmpl/seed-exception.sgml |   12 +++++++++++-
 1 files changed, 11 insertions(+), 1 deletions(-)
---
diff --git a/doc/reference/tmpl/seed-exception.sgml b/doc/reference/tmpl/seed-exception.sgml
index 2880b52..49bc7d9 100644
--- a/doc/reference/tmpl/seed-exception.sgml
+++ b/doc/reference/tmpl/seed-exception.sgml
@@ -10,7 +10,17 @@ Seed uses exceptions as a method of handling runtime errors within scripts. An e
 </para>
 
 <para>
-All Seed callbacks take an exception argument; calling seed_make_exception() with this argument and the details you wish to fill it with will propogate that exception up the chain. Exceptions can be <emphasis>caught</emphasis> either by a try/catch block in the calling JavaScript, or by observing the exception property, dealing with it, and then clearing the exception.
+All Seed callbacks take an exception argument; calling
+seed_make_exception() with this argument and the details you wish to
+fill it with will propogate that exception up the chain. Exceptions
+can be <emphasis>caught</emphasis> either by a try/catch block in the
+calling JavaScript, or by observing the exception property, dealing
+with it, and then clearing the exception.
+
+It is important to note that calling seed_make_exception(), does not
+in fact 'throw' the exception, but just creates an object, that when
+stored in the exception pointer passed to a callback, causes JSC to
+throw an exception once flow is returned.
 </para>
 
 <example>



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]