diff --git a/readme.txt b/readme.txt
index 03ba27355..2b2f4010b 100644
--- a/readme.txt
+++ b/readme.txt
@@ -80,8 +80,11 @@ Win32-MinGW            - ChibiOS/RT simulator and demo into a WIN32 process,
   Port functions are no more directly exposed as APIs to the user code.
 - NEW: Added a configuration option to enable nested system locks/unlocks.
 - NEW: Improved the interrupt handlers related code. Now interrupts are
-  handled in a very similar way for every architecture. Added macros and
-  functions that hide the implementation details.
+  handled in a very similar way for every architecture.
+- CHANGE: Renamed the macros chSysIRQEnter() and chSysIRQExit() in
+  CH_IRQ_PROLOGUE() and CH_IRQ_EPILOGUE() in order to make very clear that
+  those are not functions but inlined code. Also introduced a new macro
+  CH_IRQ_HANDLER that should be used when declaring an interrupt handler.
 
 *** 1.0.0rc2 ***
 - FIX: Removed unused variable "retaddr" from the Cortex-M3 port.