@@ -599,7 +599,11 @@ Options affecting specific writers
599599 stylesheets at absolute URLs will be downloaded; those at relative URLs
600600 will be sought relative to the working directory (if the first source
601601 file is local) or relative to the base URL (if the first source
602− file is remote). `--self-contained` does not work with `--mathjax`.
602+ file is remote). Limitation: resources that are loaded dynamically
603+ through JavaScript cannot be incorporated; as a result, `--self-contained`
604+ does not work with `--mathjax`, and some advanced features (e.g.
605+ zoom or speaker notes) may not work in an offline "self-contained"
606+ `reveal.js` slide show.
603607
604608`--offline`
605609