diff --git a/API.txt b/API.txt
index 7714723..fee8d3c 100644
--- a/API.txt
+++ b/API.txt
@@ -936,8 +936,11 @@ Flot to keep track of its state, so be careful.
 
   - getOptions()
 
-    Gets the options for the plot, in a normalized format with default
-    values filled in.
+    Gets the options for the plot, normalized, with default values
+    filled in. You get a reference to actual values used by Flot, so
+    if you modify the values in here, Flot will use the new values.
+    If you change something, you probably have to call draw() or
+    setupGrid() or triggerRedrawOverlay() to see the change.
     
 
 Hooks