diff --git a/ghc/docs/users_guide/2-09-notes.lit b/ghc/docs/users_guide/2-09-notes.lit
new file mode 100644
index 0000000000000000000000000000000000000000..e51f5c106be05bafefbbc0c09fd2ae5a0ab050a4
--- /dev/null
+++ b/ghc/docs/users_guide/2-09-notes.lit
@@ -0,0 +1,8 @@
+* unboxed the state in ST and IO, and specialised IO (it is no longer built
+  on top of ST).
+
+* reversed the sense of -fwarn-{overlapped,incomplete}-patterns.  The driver
+  now has to have the flag to provide the warning.
+
+* added the -Wnot, -W, and -Wall options.  Set up a default set of warnings,
+  namely -fwarn-{overlapped,incomplete}-patterns.