NAME

       dte - A small and flexible text editor

SYNOPSIS

       dte [-hBHKRV] [-c command] [-t ctag] [-r rcfile] [-b rcname] [[+line] file]...

OPTIONS

       -c command
              Run command, after reading the rc file and opening any file arguments. See dterc(5)
              for available commands.

       -t ctag
              Jump to source location of ctag. Requires tags file generated by ctags(1).

       -r rcfile
              Read configuration from rcfile instead of ~/.dte/rc.

       -s file
              Load file as a dte-syntax(5) file and exit. Any errors encountered are printed to
              stderr(3) and the exit status is set appropriately.

       -b rcname
              Dump the contents of the built-in rc or syntax file named rcname and exit.

       -B     Print a list of all built-in config names that can be used with the -b option and
              exit.

       -H     Don't load history files at startup or save history files on exit (see FILES
              section below). History features will work as usual but will be in-memory only and
              not persisted to the filesystem.

       -R     Don't read the rc file.

       -K     Start in a special mode that continuously reads input and prints the name and
              numeric code of each pressed key.

       -h     Display the help summary and exit.

       -V     Display the version number and exit.

BASIC USAGE

       Here are some of the default key bindings. M-x is Alt+x, ^V (or C-V) is Ctrl+v and S-left
       is Shift+left.

       S-up, S-down, S-left, S-right
              Move cursor and select characters

       C-S-left, C-S-right
              Move cursor and select whole words

       C-S-up, C-S-down
              Move cursor and select whole lines

       ^C     Copy current line or selection

       ^X     Cut current line or selection

       ^V     Paste

       ^Z     Undo

       ^Y     Redo

       M-x    Enter command mode

       ^F     Enter search mode

       F3     Search next

       F4     Search previous

       ^T     Open new tab

       M-N    Activate Nth tab

       ^W     Close tab

       ^S     Save file

       ^Q     Quit

COMMAND MODE

       Command mode allows you to run various editor commands by using a language similar to Unix
       shell. The next and prev commands switch to the next/previous file. The open, save and
       quit commands should be self-explanatory. For a full list of available commands, see
       dterc(5).

       The default key bindings for command mode are:

       up, down
              Browse previous command history.

       tab    Auto-complete current command or argument

       ^A     Go to beginning of command line

       ^B     Move left

       ^C     Exit command mode

       ^D     Delete

       ^E     Go to end of command line

       ^F     Move right

       ^K     Delete to end of command line

       ^U     Delete to beginning of command line

       ^W     Erase word

       Esc    Exit command mode

SEARCH MODE

       Search mode allows you to enter an extended regular expression to search in the current
       buffer.

       The key bindings for search mode are mostly the same as in command mode, plus these
       additional keys:

       M-c    Toggle case sensitive search option.

       M-r    Reverse search direction.

ENVIRONMENT

       DTE_HOME
              User configuration directory. Defaults to $HOME/.dte if not set.

       DTE_FORCE_TERMINFO
              Force dte to use terminfo(5) database, even for terminals with built-in support.
              Enabled if set.

       TERM   Identifier used to determine which terminfo(5) entry or built-in terminal support
              to use.

FILES

       $DTE_HOME/rc
              Your personal configuration file. See dterc(5) for a full list of available
              commands and options or run "dte -b rc" to see the built-in, default config.

       $DTE_HOME/syntax/*
              Your personal syntax files. These override the syntax files that come with the
              program. See dte-syntax(5) for more information or run "dte -b syntax/dte" for a
              basic example.

       $DTE_HOME/file-locks
              Records open files to protect you from accidentally editing files opened in another
              process. Used only if the lock-files option is enabled.

       $DTE_HOME/file-history
              History of edited files and cursor positions. Used only if the file-history option
              is enabled.

       $DTE_HOME/command-history
              History of dterc(5) commands used while in command mode.

       $DTE_HOME/search-history
              History of search patterns used while in search mode.

SEE ALSO

       dterc(5), dte-syntax(5)

AUTHORS

       Craig Barnes <cr@igbarn.es>
       Timo Hirvonen <tihirvon@gmail.com>

                                          November 2017                                    DTE(1)