diff --git a/doc/release-notes.md b/doc/release-notes.md
index a29094b51..87070c6f1 100644
--- a/doc/release-notes.md
+++ b/doc/release-notes.md
@@ -4,3 +4,10 @@ release-notes at release time)
 Notable changes
 ===============
 
+Option parsing behavior
+-----------------------
+
+Command line options are now parsed strictly in the order in which they are
+specified. It used to be the case that `-X -noX` ends up, unintuitively, with X
+set, as `-X` had precedence over `-noX`. This is no longer the case. Like for
+other software, the last specified value for an option will hold.