1
0
forked from Alepha/Alepha

Clean up some exceptions doc.

This commit is contained in:
2023-10-15 03:37:12 -04:00
parent b97ede2b86
commit b6cbf5199b

View File

@ -36,7 +36,7 @@ namespace Alepha::Hydrogen
* This exception can be thrown as part of normal program operation -- it is a control * This exception can be thrown as part of normal program operation -- it is a control
* flow device. * flow device.
* *
* * `Notification`: When a thread is cancelled using interrupts, all `Exception`s thrown * * `Notification`: When a thread is interrupted as a notification, all `Exception`s thrown
* to do so are derived from this type. Alepha threads are setup to catch and discard * to do so are derived from this type. Alepha threads are setup to catch and discard
* `Exception`s of this grade in the thread start function. It is legal to catch `Exception`s * `Exception`s of this grade in the thread start function. It is legal to catch `Exception`s
* of this type type and silence it; however, `Notification` typically means that the * of this type type and silence it; however, `Notification` typically means that the
@ -65,7 +65,8 @@ namespace Alepha::Hydrogen
* state corruption. A program probably SHOULD ignore these and allow a core dump to * state corruption. A program probably SHOULD ignore these and allow a core dump to
* be emitted. An example of this might be: Runtime detection of dereference of a * be emitted. An example of this might be: Runtime detection of dereference of a
* raw pointer set to `nullptr`. This would typically indicate some kind of program * raw pointer set to `nullptr`. This would typically indicate some kind of program
* bug. `Violation::~Violation` is setup to call `abort()` when called. * bug. `Violation::~Violation` is setup to call `abort()` when called. In some sense
* this type is what `std::logic_error` is often used to represent.
*/ */
template< typename ... Bases > template< typename ... Bases >