From 902c63ebea779cce95b2bca041ad56cbf84ff727 Mon Sep 17 00:00:00 2001
From: John MacFarlane <jgm@berkeley.edu>
Date: Mon, 23 Nov 2015 18:46:14 -0800
Subject: [PATCH] Document limitations of --self-contained.

See #2553.
---
 README | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/README b/README
index 8a3a7e021..9f00c5749 100644
--- a/README
+++ b/README
@@ -599,7 +599,11 @@ Options affecting specific writers
     stylesheets at absolute URLs will be downloaded; those at relative URLs
     will be sought relative to the working directory (if the first source
     file is local) or relative to the base URL (if the first source
-    file is remote).  `--self-contained` does not work with `--mathjax`.
+    file is remote).  Limitation: resources that are loaded dynamically
+    through JavaScript cannot be incorporated; as a result, `--self-contained`
+    does not work with `--mathjax`, and some advanced features (e.g.
+    zoom or speaker notes) may not work in an offline "self-contained"
+    `reveal.js` slide show.
 
 `--offline`