/// will be run. If a clean shutdown is needed it is recommended to only call
/// this function at a known point where there are no more destructors left
/// to run.
+///
+/// # Examples
+/// ```
+/// use std::process;
+///
+/// fn main() {
+/// println!("aborting");
+///
+/// process::abort();
+///
+/// // execution never gets here
+/// }
+/// ```
#[stable(feature = "process_abort", since = "1.17.0")]
pub fn abort() -> ! {
unsafe { ::sys::abort_internal() };