System.Runtime.ExceptionServices docs

Author: ericstj

xml/System.Runtime.ExceptionServices/ExceptionHandling.xml

@@ -43,9 +43,13 @@
         <Parameter Name="exception" Type="System.Object" />
       </Parameters>
       <Docs>
-        <param name="exception">To be added.</param>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <param name="exception">Exception to pass to event handlers.</param>
+        <summary>Raises the <see cref="E:System.AppDomain.UnhandledException" /> event.</summary>
+        <remarks>
+          <para>This method will raise the <see cref="E:System.AppDomain.UnhandledException" /> event and then return.</para>
+          <para>It will not raise the the handler registered with <see cref="M:System.Runtime.ExceptionServices.ExceptionHandling.SetUnhandledExceptionHandler(System.Func{System.Exception,System.Boolean})" />.</para>
+          <para>This API is thread safe and can be called from multiple threads. However, only one thread will trigger the event handlers, while other threads will wait indefinitely without raising the event.</para>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="SetUnhandledExceptionHandler">
@@ -68,8 +72,15 @@
       </Parameters>
       <Docs>
         <param name="handler">To be added.</param>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <summary>Sets a handler for unhandled exceptions.</summary>
+        <remarks>
+          <para>The handler will be called when an unhandled exception occurs.</para>
+          <para>The handler should return <see langword="true" /> if the exception was handled, or <see langword="false" /> if it was not.</para>
+          <para>If the handler returns <see langword="false" />, the exception will continue to propagate as unhandled.</para>
+          <para>The intent of this handler is to allow the user to handle unhandled exceptions gracefully when the runtime is being used in certain scenarios. Scenarios such as REPLs or game scripting that host plug-ins are not able to handle unhandled exceptions thrown by those plug-ins.</para>
+        </remarks>
+        <exception cref="T:System.ArgumentNullException">If handler is null</exception>
+        <exception cref="T:System.InvalidOperationException">If a handler is already set</exception>
       </Docs>
     </Member>
   </Members>