Update docs re Stata 18.5+

Author: hugetim

README.md

@@ -33,19 +33,20 @@ which is needlessly clunky if you are working primarily with Stata).
 - [x] [Easy
   setup](https://hugetim.github.io/nbstata/user_guide.html#install)
 - [x] Works with Stata 17+ (only).
-- [x] Displays Stata output without the redundant ‘echo’ of (multi-line)
-  commands
-- [x] Autocompletion for variables, macros, matrices, and file paths
 - [x] DataGrid widget with `browse`-like capabilities (e.g., interactive
   filtering)
 - [x] Variable and data properties available in a ‘contextual help’ side
   panel
-- [x] Interactive/richtext help files accessible within notebook
-- [x] `#delimit ;` interactive support (along with all types of
-  comments)
 - [x] Quarto [inline
   code](https://quarto.org/docs/computations/inline-code.html) support
 
+Users of Stata 17 or 18.0 also get these features only built-in natively
+to Stata 18.5+: - Displays Stata output without the redundant ‘echo’ of
+(multi-line) commands - Autocompletion for variables, macros, matrices,
+and file paths - Interactive/richtext help files accessible within
+notebook - `#delimit ;` interactive support (along with all types of
+comments)
+
 The video below demonstrates using Stata in a Jupyter notebook. In
 addition to the
 [NBClassic](https://nbclassic.readthedocs.io/en/stable/notebook.html)

nbs/index.ipynb

@@ -51,13 +51,15 @@
     "\n",
     "- [x] [Easy setup](https://hugetim.github.io/nbstata/user_guide.html#install)\n",
     "- [x] Works with Stata 17+ (only).\n",
-    "- [x] Displays Stata output without the redundant 'echo' of (multi-line) commands\n",
-    "- [x] Autocompletion for variables, macros, matrices, and file paths\n",
     "- [x] DataGrid widget with `browse`-like capabilities (e.g., interactive filtering)\n",
     "- [x] Variable and data properties available in a 'contextual help' side panel\n",
-    "- [x] Interactive/richtext help files accessible within notebook\n",
-    "- [x] `#delimit ;` interactive support (along with all types of comments)\n",
-    "- [x] Quarto [inline code](https://quarto.org/docs/computations/inline-code.html) support"
+    "- [x] Quarto [inline code](https://quarto.org/docs/computations/inline-code.html) support\n",
+    "\n",
+    "Users of Stata 17 or 18.0 also get these features only built-in natively to Stata 18.5+:\n",
+    "- Displays Stata output without the redundant 'echo' of (multi-line) commands\n",
+    "- Autocompletion for variables, macros, matrices, and file paths\n",
+    "- Interactive/richtext help files accessible within notebook\n",
+    "- `#delimit ;` interactive support (along with all types of comments)"
    ]
   },
   {

nbs/user_guide.ipynb

@@ -119,9 +119,9 @@
     "    Specify the last option if you want to use `pystata`'s [default setting](https://www.stata.com/python/pystata18/config.html#pystata.config.set_graph_format). \n",
     "- `graph_width`/`graph_height`: By default, graphs are generated with width 5.5in and height 4in. The width or height may be specified as a number (interpreted as inches) or a number and its unit (in, cm, or px). So `3` and `3in` are equivalent. Other valid examples: `300px` and `7.2 cm`. (Note: These values may also be set to `default`, which values alone enable the `xsize` and `ysize` options on Stata graph commands to influence the graph output size. Any values other than `default` override the `xsize` and `ysize` options.)\n",
     "- `echo`: controls the echo of commands, with the default being 'None':\n",
-    "    - 'True': the kernel will echo all commands. \n",
-    "    - 'False': the kernel will not echo single-line commands.\n",
-    "    - 'None': the kernel will not echo any command. \n",
+    "    - 'True': echo all commands. \n",
+    "    - 'False': for Stata 18.5+, not echo any command (native Stata implementation); otherwise echo (only) multi-line commands.\n",
+    "    - 'None': not echo any command (custom nbstata implementation). \n",
     "- `missing`: What to display for a missing value in the output of the `%browse`, `%head`, and `%tail` magics. Default is '.', following Stata. To defer to pandas's format for `NaN`, specify 'pandas'.\n",
     "- `browse_auto_height`: Whether to set 'height: 100%' for the [%browse](#browse-head-tail-and-frame-equivalents) widget (default: 'True'):\n",
     "  - 'True': allows browse widget to expand to height of its container, such as when using 'Create New View for Output' in Jupyter Lab.\n",
@@ -442,7 +442,9 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "The default `echo = None` configuration does some complicated things under the hood to emulate functionality that *pystata* does not directly support: running multi-line Stata code without echoing the commands. While extensive automatic tests are in place to help ensure its reliability, unanticipated issues may arise. If, while using this mode, a particular code cell is not working as expected, try placing the `%%echo` magic at the top of it to see if that resolves the issue. (If so, please report that [here](https://github.com/hugetim/nbstata/issues/new?labels=bug).) You can also avoid such potential issues by setting the config `echo = False`, which will at least not echo single-line Stata commands though it will echo multiple commands."
+    "With Stata 18.5+, `echo = False` is recommended.\n",
+    "\n",
+    "The default `echo = None` configuration does some complicated things under the hood to emulate functionality that *pystata* does not directly support: running multi-line Stata code without echoing the commands. While extensive automatic tests are in place to help ensure its reliability, unanticipated issues may arise. If, while using this mode, a particular code cell is not working as expected, try placing the `%%echo` magic at the top of it to see if that resolves the issue. (If so, please report that [here](https://github.com/hugetim/nbstata/issues/new?labels=bug).) You can also avoid such potential issues by setting the config `echo = False`, which will at least not echo single-line Stata commands though it will echo multiple commands for Stata 17 and 18.0."
    ]
   },
   {