diff options
author | Miguel de Icaza <miguel@gnome.org> | 2016-02-09 23:52:53 +0300 |
---|---|---|
committer | Miguel de Icaza <miguel@gnome.org> | 2016-02-09 23:52:58 +0300 |
commit | 871115c2d847f99e86d5cfa6aa95d2ccee61e2eb (patch) | |
tree | dadda014c3da5b46b7985637ee606c957e849ab5 /docs/sources/mono-api-exc.html | |
parent | 52b80e6c6803cec0849f1f78e2fd6ec4ba847ad8 (diff) |
[Docs] Continue to improve the Mono runtime documentation
Diffstat (limited to 'docs/sources/mono-api-exc.html')
-rw-r--r-- | docs/sources/mono-api-exc.html | 30 |
1 files changed, 19 insertions, 11 deletions
diff --git a/docs/sources/mono-api-exc.html b/docs/sources/mono-api-exc.html index f6504355ebc..88c22a1f3e8 100644 --- a/docs/sources/mono-api-exc.html +++ b/docs/sources/mono-api-exc.html @@ -1,25 +1,32 @@ <h2>Exception Handling</h2> -<div class="mapi-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>With the introduction of the Cooperative mode/Bitcode for - the Mono garbage collector, it is no longer recommended for - embedded developers to raise exceptions from any method except - the topmost registered internal call. + <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. - <p>It is recommended that you raise an error condition from - nested parts of code, surface this error and in the topmost - frame raise the exception. <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> - +<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> @@ -27,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 |