Add browse_auto_height docs, related tweak

nbs/09_magics.ipynb

@@ -459,7 +459,7 @@
     "@patch_to(StataMagics)\n",
     "def magic(self, code, kernel, cell):\n",
     "    try:\n",
-    "        if not kernel.ipydatagrid_height_set:\n",
+    "        if kernel.nbstata_config.browse_auto_height and not kernel.ipydatagrid_height_set:\n",
     "            browse.set_ipydatagrid_height()\n",
     "            kernel.ipydatagrid_height_set = True\n",
     "        name, code = self._parse_code_for_magic(code)\n",

nbs/15_install.ipynb

@@ -194,6 +194,7 @@
       "graph_height = 4in\n",
       "echo = None\n",
       "missing = .\n",
+      "browse_auto_height = True\n",
       "\n"
      ]
     }

nbs/user_guide.ipynb

@@ -123,6 +123,9 @@
     "    - 'False': the kernel will not echo single-line commands.\n",
     "    - 'None': the kernel will not echo any command. \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",
+    "  - 'False': fixed height of around 22 rows, recommended for NBClassic and VSCode.\n",
     "\n",
     "Settings must be under the title `[nbstata]`. Not all settings need be included. Example:\n",
     "\n",
@@ -361,6 +364,13 @@
     "*Display Stata status and configuration values*"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<img align=\"center\" width=\"500\" src=\"images/status example.png\" alt=\"%status example\">"
+   ]
+  },
   {
    "cell_type": "markdown",
    "metadata": {},

nbstata/magics.py

@@ -166,7 +166,7 @@ def _do_magic(self, name, code, kernel, cell):
 @patch_to(StataMagics)
 def magic(self, code, kernel, cell):
     try:
-        if not kernel.ipydatagrid_height_set:
+        if kernel.nbstata_config.browse_auto_height and not kernel.ipydatagrid_height_set:
             browse.set_ipydatagrid_height()
             kernel.ipydatagrid_height_set = True
         name, code = self._parse_code_for_magic(code)