DTE(1)

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>