ste manual


STE(1)                    BSD General Commands Manual                   STE(1)


NAME

     ste -- Simple table editor


SYNOPSIS

     ste [-hv] [tsvfile.tsv]


DESCRIPTION

     ste is a simple interactive CLI table editor.  It uses table(1) to dis-
     play and a number of POSIX shell scripts, which use vipe(1) from more-
     utils to edit files in TSV (Tab Separated Values) format.


Command line options

           ste -h  Prints usage information.

           ste -v  Prints version and commit date.


Interactive commands

     ste accepts interactive commands in its command interface.  Accepted com-
     mands are:

           / [colno] text
                     Search for text in all columns, continuing the search
                     downwards as needed.  If colno is given, limit the search
                     to column number colno (1-based).

                     When the last row was reached without a match, the user
                     will be prompted whether to continue the search from the
                     first row.

           =         Show current row.

           cols [amount]
                     Set screen width in columns to amount.  The value of 0
                     causes ste to autodetect screen width on each cycle.  If
                     amount is omitted, show current screen width.

           delete | x
                     Delete the current table row.

           edit | e  Edit the current table row.

           exit | q  Exit ste.

           G         Set current row to last.

           g [num]   Set current table row to num (header = 0).  If num is not
                     present, set current row to header row.

           help [command] | h [command]
                     Show help (about a command).  If the argument command is
                     omitted, briefly list all commands.

           insert [- | +] | i [- | +]
                     Add a row to the table before (-) or after (+) the cur-
                     rent line, or, without arguments, to the end of table.

           J [num]   Move the current row down num rows.  If num is omitted,
                     move the row down.

           j [num]   Move the current row pointer down num rows.  If num is
                     omitted, move the row pointer down.

           K [num]   Move the current row up num rows.  If num is omitted,
                     move the row up.

           k [num]   Move the current row pointer up num rows.  If num is
                     omitted, move the row pointer up.

           n         Find next occurence of previously searched text.  If the
                     argument colno was given in the last search, the search
                     will reuse it.

           print | p
                     Print (redraw) the table.

           rows [amount]
                     Set screen height in lines to amount.  The value of 0
                     causes ste to autodetect screen height on each cycle.  If
                     amount is omitted, show current screen height.

           set [[no]option]
                     Turn option on/off.  If argument is omitted, show all
                     current option states.


SEE ALSO

     table(1), transpose(1), tsvdel(1), tsvedit(1), tsvfind(1), tsvins(1),
     tsvmove(1), vipe(1)


AUTHORS

     Strahinya Radich <contact@strahinja.org>, 2023

BSD                            November 11, 2023                           BSD