[exdoc] Update warnings.

[mono.git] / docs / sources / mono-api-exc.html

diff --git a/docs/sources/mono-api-exc.html b/docs/sources/mono-api-exc.html
index 13d97ca7a8e0e81151185d05d021fd73a0eac65d..88c22a1f3e87524d651603c3ae2a2238a2abe81e 100644 (file)
--- a/docs/sources/mono-api-exc.html
+++ b/docs/sources/mono-api-exc.html
@@ -1,17 +1,32 @@
 <h2>Exception Handling</h2>
 
-<div class="header">
-@API_IDX@
-</div>
+       <p>Mono's exception handling contains methods
+       to <a href="#creating">create `MonoException*` objects</a>
+       that can be <a href="api:mono_raise_exception">raised</a>.
 
+       <p>Alternatively, you can obtain an exception that you can
+       raise from some of the most <a href="#common">common</a>
+       exceptions in the .NET Runtime.
+       
 <h3>Raising and Catching exceptions</h3>
 
+       <p>If you plan on running your code in Mono's Cooperative mode
+       for the Garbage Collector (for example, if you are using pure
+       Bitcode code generation), it you should avoid raising an
+       exception from any method that is not the entry point to the
+       internal call. 
+
+       <p>It is recommended that if you need to raise an error
+       condition from nested parts of your code, surface this error
+       to the topmost method that is surfaced as an internal call and
+       raise the exception there.
+
+       
 <h4><a name="api:mono_raise_exception">mono_raise_exception</a></h4>
 <h4><a name="api:mono_unhandled_exception">mono_unhandled_exception</a></h4>
 <h4><a name="api:mono_print_unhandled_exception">mono_print_unhandled_exception</a></h4>
-<h4><a name="api:mono_handle_exception">mono_handle_exception</a></h4>
-
 
+<a name="creating"/>
 <h3>Exception Types: General API</h3>
 
 <h4><a name="api:mono_exception_from_name_domain">mono_exception_from_name_domain</a></h4>
@@ -19,6 +34,7 @@
 <h4><a name="api:mono_exception_from_name_msg">mono_exception_from_name_msg</a></h4>
 <h4><a name="api:mono_exception_from_name_two_strings">mono_exception_from_name_two_strings</a></h4>
 
+<a name="common"/>
 <h3>Obtaining Common Exceptions</h3>
 
        <p>There are a number of common exceptions that are used by
@@ -57,3 +73,10 @@
 <h4><a name="api:mono_get_exception_missing_field">mono_get_exception_missing_field</a></h4>
 <h4><a name="api:mono_get_exception_not_supported">mono_get_exception_not_supported</a></h4>
 <h4><a name="api:mono_get_exception_reflection_type_load">mono_get_exception_reflection_type_load</a></h4>
+<h4><a name="api:mono_exception_from_token_two_strings">mono_exception_from_token_two_strings</a></h4>
+<h4><a name="api:mono_get_exception_bad_image_format2">mono_get_exception_bad_image_format2</a></h4>
+<h4><a name="api:mono_get_exception_field_access">mono_get_exception_field_access</a></h4>
+<h4><a name="api:mono_get_exception_method_access">mono_get_exception_method_access</a></h4>
+<h4><a name="api:mono_get_exception_out_of_memory">mono_get_exception_out_of_memory</a></h4>
+<h4><a name="api:mono_get_exception_runtime_wrapped">mono_get_exception_runtime_wrapped</a></h4>
+<h4><a name="api:mono_get_exception_thread_interrupted">mono_get_exception_thread_interrupted</a></h4>