EDITRC(5)                 NetBSD Programmer's Manual                 EDITRC(5)

NNAAMMEE
     eeddiittrrcc - configuration file for editline library

SSYYNNOOPPSSIISS
     eeddiittrrcc

DDEESSCCRRIIPPTTIIOONN
     The eeddiittrrcc file defines various settings to be used by the editline(3)
     library.

     The format of each line is either:
           prog:command [arg [...]]
     or
           command [arg [...]]

     _c_o_m_m_a_n_d is one of the editline(3) builtin commands.  Refer to _B_U_I_L_T_I_N
     _C_O_M_M_A_N_D_S for more information.

     _p_r_o_g is the program name string that a program defines when it calls
     el_init(3) to setup editline(3),  which is usually _a_r_g_v_[_0_]. _c_o_m_m_a_n_d will
     be executed for any program which matches _p_r_o_g.

     _p_r_o_g may also be a regex(3) style regular expression, in which case
     _c_o_m_m_a_n_d will be executed for any program that matches the regular expres-
     sion.

BBUUIILLTTIINN CCOOMMMMAANNDDSS
     The eeddiittlliinnee library has some builtin commands, which affect the way that
     the line editing and history functions operate.  These are based on simi-
     lar named builtins present in the tcsh(1) shell.

     The following builtin commands are available:

     bbiinndd [--aa] [--ee] [--kk] [--ll] [--rr] [--ss] [--vv] [_k_e_y [_c_o_m_m_a_n_d]]
           Without options, list all bound keys, and the editor command to
           which each is bound.  If _k_e_y is supplied, show the bindings for
           _k_e_y. If _k_e_y _c_o_m_m_a_n_d is supplied, bind _c_o_m_m_a_n_d to _k_e_y. Options in-
           clude:

           --ee    Bind all keys to the standard GNU Emacs-like bindings.

           --vv    Bind all keys to the standard vi(1)-like  bindings.

           --aa    List or change key bindings in the vi(1) mode alternate (com-
                 mand mode) key map.

           --kk    _k_e_y is interpreted as a symbolic arrow key name, which may be
                 one of `up', `down', `left' or `right'.

           --ll    List all editor commands and a short description of each.

           --rr    Remove a key's binding.

           --ss    _c_o_m_m_a_n_d is taken as a literal string and treated as terminal
                 input when _k_e_y is typed.  Bound keys in _c_o_m_m_a_n_d are them-
                 selves reinterpreted, and this continues for ten levels of
                 interpretation.

           _k_e_y and _c_o_m_m_a_n_d can contain control characters of the form
           `^_c_h_a_r_a_c_t_e_r' (e.g.  `^A'), and the following backslashed escape se-
           quences:



                 \\aa    Bell
                 \\bb    Backspace
                 \\ee    Escape
                 \\ff    Formfeed
                 \\nn    Newline
                 \\rr    Carriage return
                 \\tt    Horizontal tab
                 \\vv    Vertical tab
                 \\_n_n_n  The ASCII character corresponding to the octal number
                       _n_n_n.

           `\' nullifies the special meaning of the following character, if it
           has any, notably `\' and `^'.

     eecchhoottcc [--ssvv] _a_r_g _._._.
           Exercise terminal capabilities given in _a_r_g _._._.. If _a_r_g is `baud',
           `cols', `lines', `rows', `meta or' `tabs', the value of that capa-
           bility is printed, with ``yes'' or ``no'' indicating that the ter-
           minal does or does not have that capability.

           --ss returns an emptry string for non-existant capabilities, rather
           than causing an error.  --vv causes messages to be verbose.

     hhiissttoorryy
           List the history.

     tteellllttcc
           List the values of all the terminal capabilities (see termcap(5)).

     sseettttcc _c_a_p _v_a_l
           Set the terminal capability _c_a_p to _v_a_l, as defined in termcap(5).
           No sanity checking is done.

     sseettttyy [--aa] [--dd] [--qq] [--xx] [_+_m_o_d_e] [_-_m_o_d_e] [_m_o_d_e]
           Control which tty modes that eeddiittrrcc won't allow the user to change.
           --dd, --qq or --xx tells sseettttyy to act on the `edit', `quote' or `execute'
           set of tty modes respectively; defaulting to --xx.

           Without other arguments, sseettttyy lists the modes in the chosen set
           which are fixed on (`+mode') or off (`-mode'). --aa lists all tty
           modes in the chosen set regardless of the setting.  With _+_m_o_d_e,
           _-_m_o_d_e or _m_o_d_e, fixes _m_o_d_e on or off or removes control of _m_o_d_e in
           the chosen set.

SSEEEE AALLSSOO
     editline(3),  regex(3),  termcap(5)

AAUUTTHHOORRSS
     The eeddiittlliinnee library was written by Christos Zoulas, and this manual was
     written by Luke Mewburn, with some sections inspired by tcsh(1).

4.4BSD                         January 11, 1997                              2
