use published versions, doc up, update CHANGELOG

src/examples/_3_panic.rs

@@ -1,49 +1,47 @@
 //! Changing the panic handler
 //!
-//! The easiest way to change the panic handler is to use a different [panic implementation
-//! crate][0].
+//! The easiest way to change the panic handler is to use a different [panic handler crate][0].
 //!
 //! [0]: https://crates.io/keywords/panic-impl
 //!
 //! ---
 //!
 //! ```
-//! 
+//!
 //! #![no_main]
 //! #![no_std]
-//! 
-//! extern crate cortex_m;
+//!
 //! #[macro_use]
 //! extern crate cortex_m_rt as rt;
-//! // extern crate panic_abort;
-//! extern crate panic_semihosting; // reports panic messages to the host stderr using semihosting
-//! 
-//! use cortex_m::asm;
+//!
+//! // Pick one of these two panic handlers:
+//!
+//! // Reports panic messages to the host stderr using semihosting
+//! extern crate panic_semihosting;
+//!
+//! // Logs panic messages using the ITM (Instrumentation Trace Macrocell)
+//! // extern crate panic_itm;
+//!
 //! use rt::ExceptionFrame;
-//! 
-//! main!(main);
-//! 
-//! #[inline(always)]
+//!
+//! entry!(main);
+//!
 //! fn main() -> ! {
 //!     panic!("Oops")
 //! }
-//! 
-//! exception!(DefaultHandler, deh);
-//! 
-//! #[inline(always)]
-//! fn deh(_nr: u8) {
-//!     asm::bkpt();
+//!
+//! // define the hard fault handler
+//! exception!(HardFault, hard_fault);
+//!
+//! fn hard_fault(ef: &ExceptionFrame) -> ! {
+//!     panic!("HardFault at {:#?}", ef);
 //! }
-//! 
-//! exception!(HardFault, hf);
-//! 
-//! #[inline(always)]
-//! fn hf(_ef: &ExceptionFrame) -> ! {
-//!     asm::bkpt();
-//! 
-//!     loop {}
+//!
+//! // define the default exception handler
+//! exception!(*, default_handler);
+//!
+//! fn default_handler(irqn: i16) {
+//!     panic!("Unhandled exception (IRQn = {})", irqn);
 //! }
-//! 
-//! interrupts!(DefaultHandler);
 //! ```
 // Auto-generated. Do not modify.