branch: externals/firefox-javascript-repl
commit 1e0638d4115b00c0fe4abc399a2f73a3363f5ef6
Author: Thomas Fitzsimmons <[email protected]>
Commit: Thomas Fitzsimmons <[email protected]>
Mention throwaway profile in commentary
* firefox-javascript-repl.el: Mention throwaway profile in
commentary.
---
firefox-javascript-repl.el | 16 ++++++++++++----
1 file changed, 12 insertions(+), 4 deletions(-)
diff --git a/firefox-javascript-repl.el b/firefox-javascript-repl.el
index 5c63eafa66..37d8769cf3 100644
--- a/firefox-javascript-repl.el
+++ b/firefox-javascript-repl.el
@@ -21,10 +21,18 @@
;;; Commentary:
-;; REPL into a new Firefox instance's JavaScript engine. This
-;; `comint' mode is barebones and unstructured, meant for quick
-;; JavaScript experiments. Paste each statement from `example.js'
-;; into the REPL to try it out.
+;; REPL into a new Firefox instance's JavaScript engine. A new
+;; throwaway Firefox profile directory is created before each run, so
+;; you won't need to modify your existing profiles. This mode takes
+;; care of starting the new Firefox process in debugging mode, which
+;; may be tedious to do by hand.
+
+;; This `comint' mode is barebones and unstructured, meant for quick
+;; JavaScript experiments. On newer versions of Emacs with
+;; `comint-indirect-buffer' support, syntax highlighting happens on
+;; the current statement.
+
+;; Paste each statement from `example.js' into the REPL to try it out.
;; For projects you should probably use `dap-mode' and `lsp-mode'
;; instead.
