From 442efbc5dd5419ce0cb3368b58b1d62238be865b Mon Sep 17 00:00:00 2001
From: Jeff Parsons <Jeff@pcjs.org>
Date: Thu, 20 Aug 2015 10:03:40 -0700
Subject: [PATCH] Added support for evaluating references (ie, expressions in
 braces, addresses in brackets)

---
 modules/pcjs/lib/debugger.js | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/modules/pcjs/lib/debugger.js b/modules/pcjs/lib/debugger.js
index c6db0e897..8fbd41499 100644
--- a/modules/pcjs/lib/debugger.js
+++ b/modules/pcjs/lib/debugger.js
@@ -4459,6 +4459,13 @@ if (DEBUGGER) {
      *
      * Unary operators like '~' and ternary operators like '?:' are not supported; neither are parentheses.
      *
+     * However, parseReference() now makes it possible to write parenthetical-style sub-expressions by using
+     * {...} (braces), as well as address references by using [...] (brackets).
+     *
+     * Why am I using braces instead of parentheses for sub-expressions?  Because parseReference() serves
+     * multiple purposes, the other being reference replacement in message strings passing through replaceRegs(),
+     * and I didn't want parentheses taking on a new meaning in message strings.
+     *
      * @this {Debugger}
      * @param {string|undefined} sExp
      * @param {boolean} [fPrint] is true to print all resolved values, false for quiet parsing
@@ -4469,6 +4476,9 @@ if (DEBUGGER) {
         var value;
 
         if (sExp) {
+            /*
+             * First process (and eliminate) any references, aka sub-expressions.
+             */
             sExp = this.parseReference(sExp);
 
             var i = 0;