repl: docs-only deprecation of magic mode · nodejs/node@3f27f02
@@ -408,14 +408,15 @@ changes:
408408 command before writing to `output`. Defaults to [`util.inspect()`][].
409409* `completer` {Function} An optional function used for custom Tab auto
410410 completion. See [`readline.InterfaceCompleter`][] for an example.
411-* `replMode` - A flag that specifies whether the default evaluator executes
412- all JavaScript commands in strict mode, default mode, or a hybrid mode
413-("magic" mode.) Acceptable values are:
411+* `replMode` {symbol} A flag that specifies whether the default evaluator
412+executes all JavaScript commands in strict mode or default (sloppy) mode.
413+ Acceptable values are:
414414* `repl.REPL_MODE_SLOPPY` - evaluates expressions in sloppy mode.
415415* `repl.REPL_MODE_STRICT` - evaluates expressions in strict mode. This is
416416 equivalent to prefacing every repl statement with `'use strict'`.
417-* `repl.REPL_MODE_MAGIC` - attempt to evaluates expressions in default
418- mode. If expressions fail to parse, re-try in strict mode.
417+* `repl.REPL_MODE_MAGIC` - This value is **deprecated**, since enhanced
418+ spec compliance in V8 has rendered magic mode unnecessary. It is now
419+ equivalent to `repl.REPL_MODE_SLOPPY` (documented above).
419420* `breakEvalOnSigint` - Stop evaluating the current piece of code when
420421`SIGINT` is received, i.e. `Ctrl+C` is pressed. This cannot be used together
421422 with a custom `eval` function. Defaults to `false`.
@@ -461,8 +462,8 @@ environment variables:
461462- `NODE_REPL_HISTORY_SIZE` - Defaults to `1000`. Controls how many lines of
462463 history will be persisted if history is available. Must be a positive number.
463464- `NODE_REPL_MODE` - May be any of `sloppy`, `strict`, or `magic`. Defaults
464- to `magic`, which will automatically run "strict mode only" statements in
465-strict mode.
465+ to `sloppy`, which will allow non-strict mode code to be run. `magic` is
466+**deprecated** and treated as an alias of `sloppy`.
466467467468### Persistent History
468469