diff --git a/doc/filters/escape.rst b/doc/filters/escape.rst
index e9ff539b69f..91f39acb020 100644
--- a/doc/filters/escape.rst
+++ b/doc/filters/escape.rst
@@ -42,7 +42,9 @@ documents:
 * ``html``: escapes a string for the **HTML body** context, 
   or for HTML attributes values **inside quotes**.
 
-* ``js``: escapes a string for the **JavaScript** context.
+* ``js``: escapes a string for the **JavaScript** context. This is intended for 
+  use in JavaScript or JSON strings, and encodes values using backslash escape 
+  sequences.
 
 * ``css``: escapes a string for the **CSS** context. CSS escaping can be
   applied to any string being inserted into CSS and escapes everything except