diff --git a/CHANGES b/CHANGES
index 633d9cf8e..7698278aa 100644
--- a/CHANGES
+++ b/CHANGES
@@ -6,6 +6,8 @@ CHANGES IN FLTK 1.1.8
STR #1742, STR #1777, STR #1794, STR #1827, STR #1843,
STR #1796, STR #1815, STR #1726, STR #1753, STR #1855,
STR #1862, STR #1867, STR #1874)
+ - Added documentation about the potential limitations
+ of Fl::grab on newer operating systems (STR #1747)
- Fixed lockout when mixing popups and alerts
(STR # 1869)
- Fixed recursion crash in event handling (STR #1873)
diff --git a/documentation/Fl.html b/documentation/Fl.html
index eda478f56..443d4eacc 100644
--- a/documentation/Fl.html
+++ b/documentation/Fl.html
@@ -943,6 +943,9 @@ and faster on the system.
Be careful that your program does not enter an infinite loop
while grab() is on. On X this will lock up your screen!
+To avoid this potential lockup, all newer operating systems seem to
+limit mouse pointer grabbing to the time during which a mouse button
+is held down. Some OS's may noy support grabbing at all.