visidata 3.1.1__py3-none-any.whl → 3.3__py3-none-any.whl

visidata/loaders/npy.py

@@ -1,4 +1,5 @@
-from visidata import VisiData, vd, Sheet, date, anytype, options, Column, Progress, ColumnItem, vlen, PyobjSheet, TypedWrapper
+from visidata import VisiData, vd, Sheet, date, anytype, options, Column, ItemColumn, Progress, vlen, PyobjSheet, TypedWrapper
+from itertools import chain
 
 'Loaders for .npy and .npz.  Save to .npy.  Depends on the zip loader.'
 
@@ -11,44 +12,74 @@ def open_npz(vd, p):
     return NpzSheet(p.base_stem, source=p)
 
 vd.option('npy_allow_pickle', False, 'numpy allow unpickling objects (unsafe)')
+vd.option('npy_matrix_enumerate', False, 'enumerate matrix rows and columns')
 
 class NpySheet(Sheet):
     def iterload(self):
         numpy = vd.importExternal('numpy')
         if not hasattr(self, 'npy'):
-            self.npy = numpy.load(str(self.source), encoding='bytes', **self.options.getall('npy_'))
+            self.npy = numpy.load(str(self.source), encoding='bytes', allow_pickle=bool(self.options.npy_allow_pickle))
         self.reloadCols()
-        yield from Progress(self.npy, total=len(self.npy))
+        transpose = len(self.npy.shape)==1 and not bool(self.npy.dtype.names)
+        if transpose:
+            source = self.npy[:,None]
+        else:
+            source = self.npy
+
+        nrows = len(self.npy)
+
+        if self.options.npy_matrix_enumerate:
+            source = list(list((chain((i,), row))) for i, row in enumerate(source))
+
+        yield from Progress(source, nrows)
+
 
     def reloadCols(self):
         self.columns = []
-        for i, (name, fmt, *shape) in enumerate(self.npy.dtype.descr):
-            if not name:
-                continue
-            if shape:
-                t = anytype
-            elif 'M' in fmt:
-                self.addColumn(Column(name, type=date, getter=lambda c,r,i=i: str(r[i])))
-                continue
-            elif 'i' in fmt:
-                t = int
-            elif 'f' in fmt:
-                t = float
+        if len(self.npy.shape)==1:
+            for i, (colname, fmt, *shape) in enumerate(self.npy.dtype.descr):
+                if not colname:
+                    colname = f"col{i}"
+                ctype = _guess_type(shape, fmt)
+                if ctype=="time":
+                    self.addColumn(Column(colname, type=date, getter=lambda c,r,i=i: str(r[i])))
+                    continue
+                self.addColumn(ItemColumn(colname, i, type=ctype))
+        elif len(self.npy.shape)==2:
+            ncols = self.npy.shape[1]
+            ctype = _guess_type(None, self.npy.dtype.descr[0][1])
+
+            if self.options.npy_matrix_enumerate:
+                self.addColumn(ItemColumn("row", 0, width=8, keycol=1, type=int), index=0)
+                for i in range(ncols):
+                    self.addColumn(ItemColumn(f'col{i}', i+1, width=8, type=ctype), index=i+1)
             else:
-                t = anytype
-            self.addColumn(ColumnItem(name, i, type=t))
-
+                for i in range(ncols):
+                    self.addColumn(ItemColumn('', i, width=8, type=ctype), index=i)
+        else:
+            vd.fail(f"too many dimensions in shape {self.npy.shape}")
+
+def _guess_type(shape, fmt):
+    if shape:
+        return anytype
+    elif 'M' in fmt:
+        return "time"
+    elif 'i' in fmt or 'u' in fmt:
+        return int
+    elif 'f' in fmt:
+        return float
+    return anytype
 
 class NpzSheet(vd.ZipSheet):
     # rowdef: tuple(tablename, table)
     columns = [
-        ColumnItem('name', 0),
-        ColumnItem('length', 1, type=vlen),
+        ItemColumn('name', 0),
+        ItemColumn('length', 1, type=vlen),
     ]
 
     def iterload(self):
         numpy = vd.importExternal('numpy')
-        self.npz = numpy.load(str(self.source), encoding='bytes', **self.options.getall('npy_'))
+        self.npz = numpy.load(str(self.source), encoding='bytes', allow_pickle=bool(self.options.npy_allow_pickle))
         yield from Progress(self.npz.items())
 
     def openRow(self, row):
@@ -74,7 +105,7 @@ def save_npy(vd, p, sheet):
         elif col.type in vd.numericTypes:
             dt = 'f8'
         else: #  if col.type in (str, anytype):
-            width = col.getMaxWidth(sheet.rows)
+            width = col.getMaxDataWidth(sheet.rows)
             dt = 'U'+str(width)
         dtype.append((col.name, dt))
 
@@ -94,4 +125,4 @@ def save_npy(vd, p, sheet):
 
     arr = np.array(data, dtype=dtype)
     with p.open_bytes(mode='w') as outf:
-        np.save(outf, arr, **sheet.options.getall('npy_'))
+        np.save(outf, arr, allow_pickle=bool(sheet.options.npy_allow_pickle))

visidata/loaders/orgmode.py

@@ -55,8 +55,8 @@ def encode_date(dt=None):
 
 
 class OrgContentsColumn(Column):
-    def setValue(self, row, v):
-        super().setValue(row, v)
+    def setValue(self, row, v, setModified=True):
+        super().setValue(row, v, setModified=setModified)
         orgmode_parse_into(row, v)
 
     def putValue(self, row, v):
@@ -88,6 +88,7 @@ def sectionize(lines):
 
 def orgmode_parse(all_lines):
     root = parent = OrgSheet().newRow()
+    root.orig_contents = ''
     for linenum, lines in sectionize(all_lines):
         section = OrgSheet().newRow()
 

visidata/loaders/pandas_freqtbl.py

@@ -83,6 +83,10 @@ class PandasFreqTableSheet(PivotSheet):
         self.source._selectByILoc(row.sourcerows.mask_iloc, selected=False)
         return super().unselectRow(row)
 
+    def addUndoSelection(self):
+        self.source.addUndoSelection()
+        super().addUndoSelection()
+
     def updateLargest(self, grouprow):
         self.largest = max(self.largest, len(grouprow.sourcerows))
 

visidata/loaders/psv.py

@@ -0,0 +1,13 @@
+from visidata import VisiData, TsvSheet
+
+
+@VisiData.api
+def open_psv(vd, p):
+    return PsvSheet(p.name, source=p)
+
+
+class PsvSheet(TsvSheet):
+    pass
+
+
+PsvSheet.options.delimiter = '|'

visidata/loaders/sqlite.py

@@ -20,7 +20,7 @@ def requery(url, **kwargs):
 @VisiData.api
 def guess_sqlite(vd, p):
     if p.open_bytes().read(16).startswith(b'SQLite format'):
-        return dict(filetype='sqlite')
+        return dict(filetype='sqlite', _likelihood=10)
 
 
 @VisiData.api

visidata/loaders/vds.py

@@ -2,7 +2,7 @@
 
 import json
 
-from visidata import VisiData, JsonSheet, Progress, IndexSheet, SettableColumn, ItemColumn, ExprColumn
+from visidata import vd, VisiData, JsonSheet, Progress, IndexSheet, SettableColumn, ItemColumn, ExprColumn
 
 
 NL='\n'
@@ -80,11 +80,10 @@ class VdsSheet(JsonSheet):
                     classname = 'ItemColumn'
                     d['expr'] = d['name']
 
-                c = globals()[classname](d.pop('name'), sheet=self)
+                c = vd.getGlobals()[classname](d.pop('name'), sheet=self)
                 self.addColumn(c)
                 self.colnames[c.name] = c
-                for k, v in d.items():
-                    setattr(c, k, v)
+                c.__setstate__(d)  # must happen after addColumn sets .sheet
 
                 line = fp.readline()
 

visidata/macros.py

@@ -40,7 +40,7 @@ class MacroSheet(IndexSheet):
     def putChanges(self):
         self.commitDeletes()  #1569  apply deletes early for saveSheets below
 
-        vd.saveSheets(self.source, self, confirm_overwrite=False)
+        vd.sync(vd.saveSheets(self.source, self, confirm_overwrite=False))
         self._deferredDels.clear()
         self.reload()
 
@@ -107,9 +107,10 @@ def afterExecSheet(cmdlog, sheet, escaped, err):
     if not vd.activeCommand: return
     if vd.activeCommand.longname == 'macro-record': return
 
-    cmd = copy(vd.activeCommand)
-    cmd.sheet = ''
-    vd.macroMode.addRow(cmd)
+    if vd.activeCommand.replayable:
+        cmd = copy(vd.activeCommand)
+        cmd.sheet = ''
+        vd.macroMode.addRow(cmd)
 
 
 @CommandLogJsonl.api

visidata/main.py

@@ -2,7 +2,7 @@
 # Usage: $0 [<options>] [<input> ...]
 #        $0 [<options>] --play <cmdlog> [--batch] [-w <waitsecs>] [-o <output>] [field=value ...]
 
-__version__ = '3.1.1'
+__version__ = '3.3'
 __version_info__ = 'saul.pw/VisiData v' + __version__
 
 from copy import copy
@@ -16,7 +16,7 @@ import signal
 import warnings
 import builtins  # to override print
 
-from visidata import vd, options, run, BaseSheet, AttrDict
+from visidata import vd, options, run, BaseSheet, AttrDict, stacktrace
 from visidata import Path
 from visidata.settings import _get_config_file
 import visidata
@@ -189,7 +189,7 @@ def main_vd():
         vd.warning(e)
 
     warnings.showwarning = vd.warning
-    vd.printout = builtins.print
+    vd.printerr = lambda *args: builtins.print(*args, file=sys.stderr)
 
     flPipedInput = not sys.stdin.isatty()
     flPipedOutput = not sys.stdout.isatty()
@@ -255,7 +255,11 @@ def main_vd():
                         optval = sys.argv[i+1]
                         i += 1
 
-            current_args[optname] = optval
+            # batch and interactive are only meaningful when applied globally,
+            # so exclude them from sheet-specific options. Those would
+            # override any later change to vd.options.batch in global settings.
+            if optname not in ('batch', 'interactive'):
+                current_args[optname] = optval
             if flGlobal:
                 global_args[optname] = optval
         elif arg.startswith('+'):  # position cursor at start
@@ -285,7 +289,7 @@ def main_vd():
     # fetch motd *after* options parsing/setting
     vd.domotd()
 
-    if args.batch:
+    if options.batch:
         if not vd.options.interactive:
             options.undo = False
             options.quitguard = False
@@ -316,7 +320,7 @@ def main_vd():
     for vs in reversed(sources):
         vd.push(vs, load=False) #1471, 1555
 
-    if not vd.sheets and not args.play and not args.batch:
+    if not vd.sheets and not args.play and not options.batch:
         if 'filetype' in current_args:
             newfunc = getattr(vd, 'new_' + current_args['filetype'], vd.getGlobals().get('new_' + current_args['filetype']))
             datestr = datetime.date.today().strftime('%Y-%m-%d')
@@ -333,23 +337,25 @@ def main_vd():
             vd.cmdlog.openHook(vd.currentDirSheet, vd.currentDirSheet.source)
 
     if not args.play:
-        if args.batch:
+        if options.batch:
             if sources:
                 vd.push(sources[0])
 
         for (f, *parms) in after_config:
             f(sources, *parms)
 
-        if not args.batch:
+        if not options.batch:
             run(vd.sheets[0])
     else:
         if args.play == '-':
+            if vd.stdinSource.fptext.isatty():
+                vd.fail('replay commands must come by pipe, not by terminal')
             vdfile = vd.stdinSource
         else:
             vdfile = Path(args.play)
 
         vs = eval_vd(vdfile, *fmtargs, **fmtkwargs)
-        if args.batch:
+        if options.batch:
             if not args.debug:
                 vd.outputProgressThread = visidata.VisiData.execAsync(vd, vd.outputProgressEvery, vs, seconds=0.5, sheet=BaseSheet())  #1182
             vd.reloadMacros()
@@ -357,6 +363,7 @@ def main_vd():
                 return 1
 
             if vd.options.interactive:
+                vd.options.batch = False  #2639
                 vd.execAsync = lambda *args, vd=vd, **kwargs: visidata.VisiData.execAsync(vd, *args, **kwargs)
                 run()
         else:
@@ -369,7 +376,7 @@ def main_vd():
 
     saver_threads = [t for t in vd.unfinishedThreads if t.name.startswith('save_')]
     if saver_threads:
-        vd.printout('finishing %d savers' % len(saver_threads))
+        vd.printerr('finishing %d savers' % len(saver_threads))
         vd.sync(*saver_threads)
 
     vd._stdout.flush()
@@ -386,9 +393,12 @@ def vd_cli():
         if vd.options.debug:
             raise
     except FileNotFoundError as e:
-        print(e)
+        print(e, file=sys.stderr)
         if options.debug:
             raise
+    except Exception as e:
+        for l in stacktrace(): #show the stack trace without carets
+            print(l, file=sys.stderr)
 
     sys.stderr.flush()
     sys.stdout.flush()

visidata/mainloop.py

@@ -64,6 +64,7 @@ def setWindows(vd, scr, pct=None):
     disp_menu = getattr(vd, 'menuRunning', None) or vd.options.disp_menu
     topmenulines = 1 if disp_menu else 0
     h, w = scr.getmaxyx()
+    if h == 1: topmenulines = 0
 
     n = 0
     if pct:
@@ -71,6 +72,7 @@ def setWindows(vd, scr, pct=None):
         n = abs(pct)*h//100
         n = min(n, h-topmenulines-3)
         n = max(3, n)
+        if n > h: n = 0
 
     desiredConfig = dict(pct=pct, n=n, h=h-topmenulines, w=w)
 
@@ -165,7 +167,7 @@ def mainloop(vd, scr):
     numTimeouts = 0
     prefixWaiting = False
     vd.scrFull = scr
-    if vd.options.disp_expert >= 5:
+    if not vd.wantsHelp('help'):
         vd.disp_help = -1
 
     vd.keystrokes = ''
@@ -251,13 +253,14 @@ def mainloop(vd, scr):
         vd.checkForFinishedThreads()
         vd.callNoExceptions(sheet.checkCursor)
 
-        # no idle redraw unless background threads are running
         time.sleep(0)  # yield to other threads which may not have started yet
         if vd._nextCommands:
-            if vd.options.replay_wait > 0:
-                vd.curses_timeout = int(vd.options.replay_wait*1000)
-            else:
+            if vd.unfinishedThreads:  #2369 #2635
+                # while running a bg thread for a command, schedule infrequent redraws
                 vd.curses_timeout = nonidle_timeout
+            else:
+                # otherwise, schedule the next redraw and command (immediately, for default replay_wait)
+                vd.curses_timeout = int(vd.options.replay_wait*1000)
         elif vd.unfinishedThreads:
             vd.curses_timeout = nonidle_timeout
         else:

visidata/man/parse_options.py

@@ -4,6 +4,7 @@
 
 import sys
 import visidata
+dispwidth = visidata.dispwidth
 
 
 fncli, fnopts = sys.argv[1:]
@@ -31,7 +32,7 @@ with open(fncli, 'w') as cliOut:
         optkeys = visidata.options.keys()
         optvalues = [visidata.options._opts._get(optname) for optname in optkeys]
 
-        widestoptwidth, widestopt = sorted((len(opt.name)+len(str(opt.value)), opt.name) for opt in optvalues)[-1]
+        widestoptwidth, widestopt = sorted((dispwidth(opt.name)+dispwidth(str(opt.value)), opt.name) for opt in optvalues)[-1]
         print('widest option+default is "%s", width %d' % (widestopt, widestoptwidth))
         widestoptwidth = 35
         menuOut.write('.Bl -tag -width %s -compact\n' % ('X'*(widestoptwidth+3)))
@@ -51,7 +52,7 @@ with open(fncli, 'w') as cliOut:
             else:
                 cli_optname=opt.name.replace('_', '-')
                 cli_type=type(opt.value).__name__
-                optlen = len(cli_optname)+len(cli_type)+1
+                optlen = dispwidth(cli_optname)+dispwidth(cli_type)+1
                 if cli_type != 'bool' or visidata.options.getdefault(opt.name):
                     cliOut.write(options_cli_skel.format(cli_optname=cli_optname,
                                                     optname = opt.name,

visidata/man/vd.1

@@ -1,4 +1,4 @@
-.Dd October 13, 2024
+.Dd June 13, 2025
 .Dt vd \&1 "Quick Reference Guide"
 .Os Linux/MacOS
 .
@@ -193,6 +193,8 @@ adjust widths of all visible columns to Ar number
 .Pp
 .It Ic " -" Ns " (hyphen)"
 hide current column
+.It Ic "g-" Ns " (hyphen)"
+hide any column that has multiple rows but only one distinct value
 .It Ic "z-" Ns
 reduce width of current column by half
 .It Ic "gv" Ns
@@ -247,10 +249,10 @@ add/reset cache for current/all visible column(s)
 .No add new columns from capture groups of Ar regex No (also requires example row)
 .It Ic "z" Ns Ic "\&;" Ar expr
 .No create new column from bash Ar expr Ns , with Sy $ Ns columnNames as variables
-.It Ic " *" Ar regex Ns Sy / Ns Ar subst
-.No add column derived from current column, replacing Ar regex No with Ar subst No (may include Sy \e1 No backrefs)
-.It Ic "g*  gz*" Ar regex Ns Sy / Ns Ar subst
-.No modify selected rows in current/all visible column(s), replacing Ar regex No with Ar subst No (may include Sy \e1 No backrefs)
+.It Ic " *" Ar search No Sy Tab No Ar replace
+.No add column derived from current column, replacing Ar search No regex with Ar replace No (may include Sy \e1 No backrefs)
+.It Ic "g*  gz*" Ar search No Sy Tab No Ar replace
+.No modify selected rows in current/all visible column(s), replacing Ar search No with Ar replace No (may include Sy \e1 No backrefs)
 .Pp
 .It Ic " (   g("
 .No expand current/all visible column(s) of lists (e.g. Sy [3] Ns ) or dicts (e.g. Sy {3} Ns ) one level
@@ -300,7 +302,7 @@ sort ascending/descending by current column; replace any existing sort criteria
 .It Ic " g[   g]"
 sort ascending/descending by all key columns; replace any existing sort criteria
 .It Ic " z[   z]"
-sort ascending/descending by current column; add to existing sort criteria
+sort ascending/descending by current column; keep higher priority sort criteria
 .It Ic "gz[  gz]"
 sort ascending/descending by all key columns; add to existing sort criteria
 .It Ic " \&""
@@ -316,6 +318,8 @@ open duplicate sheet with deepcopy of selected rows
 The rows in these duplicated sheets (except deepcopy) are references to rows on the original source sheets, and so edits to the filtered rows will naturally be reflected in the original rows.  Use
 .Ic "g'"
 to freeze sheet contents in a deliberate copy.
+.Ic "z'"
+replace current column with a frozen copy, with all cells evaluated
 .
 .Ss Editing Rows and Cells
 .
@@ -352,6 +356,8 @@ fill null cells in current column with contents of non-null cells up the current
 .
 .It Ic "  e" Ar text
 edit contents of current cell
+.It Ic " ^O"
+.No edit contents of current cell in external Sy EDITOR
 .It Ic " ge" Ar text
 .No set contents of current column for selected rows to Ar text
 .
@@ -443,6 +449,8 @@ increase/decrease zoom level, centered on cursor
 zoom to fit full extent
 .It Ic "z_" No (underbar)
 set aspect ratio
+.It Ic "g_" No (underbar)
+Zoom y-axis to fit all visible data points
 .It Ic " x" Ar xmin xmax
 .No set Ar xmin Ns / Ns Ar xmax No on graph
 .It Ic " y" Ar ymin ymax
@@ -782,7 +790,7 @@ abort replay
 .It Ic  ^T
 .No open global Sy Threads Sheet No for all asynchronous threads running
 .It Ic z^T
-.No open current sheet's Sy Threads Sheet No
+.No open current sheet's Sy Threads Sheet
 .El
 .Bl -inset -compact
 .It (sheet-specific commands)
@@ -791,7 +799,7 @@ abort replay
 .It Ic " ^C"
 abort thread at current row
 .It Ic "g^C"
-.No abort all threads on current Sy Threads Sheet No
+.No abort all threads on current Sy Threads Sheet
 .El
 .
 .Ss DERIVED SHEETS
@@ -912,7 +920,7 @@ disable loading .visidatarc and plugin addons
 .
 .El
 .Bl -tag -width XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX -compact
-.It Sy --visidata-dir Ns = Ns Ar "str          " No "~/.visidata/"
+.It Sy --visidata-dir Ns = Ns Ar "str          " No "/home/anja/.config/visidata"
 directory to load and store additional files
 .It Sy --debug No "                     False"
 exit on error and display stacktrace
@@ -1021,7 +1029,7 @@ source of randomized startup messages
 folder recursion depth on DirSheet
 .It Sy --dir-hidden No "                False"
 load hidden files on DirSheet
-.It Sy --config Ns = Ns Ar "Path               " No "/home/saul/.visidatarc"
+.It Sy --config Ns = Ns Ar "Path               " No "/home/anja/.visidatarc"
 config file to exec in Python
 .It Sy --play Ns = Ns Ar "str                  " No ""
 file.vdj to replay
@@ -1055,7 +1063,7 @@ device ID associated with matrix login
 client_id for reddit api
 .It Sy --reddit-client-secret Ns = Ns Ar "str  " No ""
 client_secret for reddit api
-.It Sy --reddit-user-agent Ns = Ns Ar "str     " No "3.1dev"
+.It Sy --reddit-user-agent Ns = Ns Ar "str     " No "3.3"
 user_agent for reddit api
 .It Sy --zulip-batch-size Ns = Ns Ar "int      " No "-100"
 number of messages to fetch per call (<0 to fetch before anchor)
@@ -1100,6 +1108,8 @@ max number of fixed-width columns to create (0 is no max)
 whether to include edge labels on graphviz diagrams
 .It Sy --grep-base-dir Ns = Ns Ar "NoneType    " No "None"
 base directory for relative paths opened with sysopen-row
+.It Sy --hdf5-matrix-enumerate No "     False"
+enumerate matrix rows and columns
 .It Sy --html-title Ns = Ns Ar "str            " No "<h2>{sheet.name}</h2>"
 table header when saving to html
 .It Sy --http-max-next Ns = Ns Ar "int         " No "0"
@@ -1110,6 +1120,8 @@ http headers to send to requests
 verify host and certificates for https
 .It Sy --npy-allow-pickle No "          False"
 numpy allow unpickling objects (unsafe)
+.It Sy --npy-matrix-enumerate No "      False"
+enumerate matrix rows and columns
 .It Sy --pcap-internet Ns = Ns Ar "str         " No "n"
 (y/s/n) if save_dot includes all internet hosts separately (y), combined (s), or does not include the internet (n)
 .It Sy --pdf-tables No "                False"
@@ -1144,8 +1156,6 @@ API Key for api.apilayer.com/fixer
 Cache days for currency conversions
 .It Sy --describe-aggrs Ns = Ns Ar "str        " No "mean stdev"
 numeric aggregators to calculate on Describe sheet
-.It Sy --hello-world Ns = Ns Ar "str           " No "\[u00A1]Hola mundo!"
-shown by the hello-world command
 .It Sy --incr-base Ns = Ns Ar "float           " No "1.0"
 start value for column increments
 .It Sy --ping-count Ns = Ns Ar "int            " No "3"
@@ -1193,7 +1203,7 @@ command submenu indicator
 indicator if command pushes sheet onto sheet stack
 .It Sy "disp_menu_input    " No "\[u2026]"
 indicator if input required for command
-.It Sy "disp_menu_fmt      " No "| VisiData {vd.version} | {vd.hintStatus}"
+.It Sy "disp_menu_fmt      " No "| VisiData {vd.version} | {vd.motd}"
 right-side menu format string
 .It Sy "disp_float_fmt     " No "{:.02f}"
 default fmtstr to format float values
@@ -1305,6 +1315,8 @@ replace whitespace with spaces in multiline
 multiline string to indicate truncation
 .It Sy "disp_multiline_focus" No "True"
 only multiline cursor row
+.It Sy "color_multiline_bottom" No ""
+color of bottom line of multiline rows
 .It Sy "color_aggregator   " No "bold 255 white on 234 black"
 color of aggregator summary on bottom row
 .It Sy "disp_rstatus_fmt   " No "{sheet.threadStatus} {sheet.keystrokeStatus}   [:longname_status]{sheet.longname}[/]  {sheet.nRows:9d} {sheet.rowtype} {sheet.modifiedStatus}{sheet.selectedStatus}{vd.replayStatus}{vd.sidebarStatus}"
@@ -1365,7 +1377,7 @@ histogram element character
 show axes and legend on graph
 .It Sy "disp_canvas_charset" No "\[u2800]\[u2801]\[u2802]\[u2803]\[u2804]\[u2805]\[u2806]\[u2807]\[u2808]\[u2809]\[u280A]\[u280B]\[u280C]\[u280D]\[u280E]\[u280F]\[u2810]\[u2811]\[u2812]\[u2813]\[u2814]\[u2815]\[u2816]\[u2817]\[u2818]\[u2819]\[u281A]\[u281B]\[u281C]\[u281D]\[u281E]\[u281F]\[u2820]\[u2821]\[u2822]\[u2823]\[u2824]\[u2825]\[u2826]\[u2827]\[u2828]\[u2829]\[u282A]\[u282B]\[u282C]\[u282D]\[u282E]\[u282F]\[u2830]\[u2831]\[u2832]\[u2833]\[u2834]\[u2835]\[u2836]\[u2837]\[u2838]\[u2839]\[u283A]\[u283B]\[u283C]\[u283D]\[u283E]\[u283F]\[u2840]\[u2841]\[u2842]\[u2843]\[u2844]\[u2845]\[u2846]\[u2847]\[u2848]\[u2849]\[u284A]\[u284B]\[u284C]\[u284D]\[u284E]\[u284F]\[u2850]\[u2851]\[u2852]\[u2853]\[u2854]\[u2855]\[u2856]\[u2857]\[u2858]\[u2859]\[u285A]\[u285B]\[u285C]\[u285D]\[u285E]\[u285F]\[u2860]\[u2861]\[u2862]\[u2863]\[u2864]\[u2865]\[u2866]\[u2867]\[u2868]\[u2869]\[u286A]\[u286B]\[u286C]\[u286D]\[u286E]\[u286F]\[u2870]\[u2871]\[u2872]\[u2873]\[u2874]\[u2875]\[u2876]\[u2877]\[u2878]\[u2879]\[u287A]\[u287B]\[u287C]\[u287D]\[u287E]\[u287F]\[u2880]\[u2881]\[u2882]\[u2883]\[u2884]\[u2885]\[u2886]\[u2887]\[u2888]\[u2889]\[u288A]\[u288B]\[u288C]\[u288D]\[u288E]\[u288F]\[u2890]\[u2891]\[u2892]\[u2893]\[u2894]\[u2895]\[u2896]\[u2897]\[u2898]\[u2899]\[u289A]\[u289B]\[u289C]\[u289D]\[u289E]\[u289F]\[u28A0]\[u28A1]\[u28A2]\[u28A3]\[u28A4]\[u28A5]\[u28A6]\[u28A7]\[u28A8]\[u28A9]\[u28AA]\[u28AB]\[u28AC]\[u28AD]\[u28AE]\[u28AF]\[u28B0]\[u28B1]\[u28B2]\[u28B3]\[u28B4]\[u28B5]\[u28B6]\[u28B7]\[u28B8]\[u28B9]\[u28BA]\[u28BB]\[u28BC]\[u28BD]\[u28BE]\[u28BF]\[u28C0]\[u28C1]\[u28C2]\[u28C3]\[u28C4]\[u28C5]\[u28C6]\[u28C7]\[u28C8]\[u28C9]\[u28CA]\[u28CB]\[u28CC]\[u28CD]\[u28CE]\[u28CF]\[u28D0]\[u28D1]\[u28D2]\[u28D3]\[u28D4]\[u28D5]\[u28D6]\[u28D7]\[u28D8]\[u28D9]\[u28DA]\[u28DB]\[u28DC]\[u28DD]\[u28DE]\[u28DF]\[u28E0]\[u28E1]\[u28E2]\[u28E3]\[u28E4]\[u28E5]\[u28E6]\[u28E7]\[u28E8]\[u28E9]\[u28EA]\[u28EB]\[u28EC]\[u28ED]\[u28EE]\[u28EF]\[u28F0]\[u28F1]\[u28F2]\[u28F3]\[u28F4]\[u28F5]\[u28F6]\[u28F7]\[u28F8]\[u28F9]\[u28FA]\[u28FB]\[u28FC]\[u28FD]\[u28FE]\[u28FF]"
 charset to render 2x4 blocks on canvas
-.It Sy "disp_pixel_random  " No "False"
+.It Sy "disp_graph_pixel_random" No "False"
 randomly choose attr from set of pixels instead of most common
 .It Sy "disp_zoom_incr     " No "2.0"
 amount to multiply current zoomlevel when zooming
@@ -1385,8 +1397,17 @@ charset to render vertical reference lines on graph
 charset to render horizontal reference lines on graph
 .It Sy "disp_graph_multiple_reflines_char" No "\[u2592]"
 char to render multiple parallel reflines
-.It Sy "disp_expert        " No "0"
-max level of options and columns to include
+.It Sy "disp_help_flags    " No "cmdpalette guides help hints inputfield inputkeys nometacols sidebar"
+list of helper features to enable (space-separated):
+    - "cmdpalette": exec-longname suggestions
+    - "guides": guides in sidebar
+    - "help": help sidebar collapsed by default
+    - "hints": context-sensitive hints on menu line
+    - "inputfield": context-sensitive help for each input field
+    - "inputkeys": input quick reference in sidebar
+    - "nometacols": hide expert columns on metasheets
+    - "sidebar": context-sensitive sheet help in sidebar
+    - "all": enable all helper features
 .It Sy "color_add_pending  " No "green"
 color for rows pending add
 .It Sy "color_change_pending" No "reverse yellow"