Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
EDITRC(5)		    BSD	File Formats Manual		     EDITRC(5)

     editrc -- configuration file for editline library


     The editrc	file defines various settings to be used by the	editline(3)

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

     command is	one of the editline(3) builtin commands.  Refer	to BUILTIN
     COMMANDS for more information.

     prog is the program name string that a program defines when it calls
     el_init(3)	to setup editline(3), which is usually argv[0].	 command will
     be	executed for any program which matches prog.

     prog may also be a	regex(3) style regular expression, in which case
     command will be executed for any program that matches the regular expres-

     The editline 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:

     bind [-a] [-e] [-k] [-l] [-r] [-s]	[-v] [key [command]]
	   Without options, list all bound keys, and the editor	command	to
	   which each is bound.	 If key	is supplied, show the bindings for
	   key.	 If key	command	is supplied, bind command to key.  Options in-

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

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

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

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

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

	   -r	 Remove	a key's	binding.

	   -s	 command is taken as a literal string and treated as terminal
		 input when key	is typed.  Bound keys in command are them-
		 selves	reinterpreted, and this	continues for ten levels of

	   key and command can contain control characters of the form
	   `^character'	(e.g. `^A'), and the following backslashed escape se-

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

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

     echotc [-sv] arg ...
	   Exercise terminal capabilities given	in arg ....  If	arg is `baud',
	   `cols', `lines', `rows', `meta or' `tabs', the value	of that	capa-
	   bility is printed, with "yes" or "no" indicating that the terminal
	   does	or does	not have that capability.

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

	   List	the history.

	   List	the values of all the terminal capabilities (see termcap(5)).

     settc cap val
	   Set the terminal capability cap to val, as defined in termcap(5).
	   No sanity checking is done.

     setty [-a]	[-d] [-q] [-x] [+mode] [-mode] [mode]
	   Control which tty modes that	editrc won't allow the user to change.
	   -d, -q or -x	tells setty to act on the `edit', `quote' or `execute'
	   set of tty modes respectively; defaulting to	-x.

	   Without other arguments, setty lists	the modes in the chosen	set
	   which are fixed on (`+mode')	or off (`-mode').  -a lists all	tty
	   modes in the	chosen set regardless of the setting.  With +mode,
	   -mode or mode, fixes	mode on	or off or removes control of mode in
	   the chosen set.

     editline(3), regex(3), termcap(5)

     The editline library was written by Christos Zoulas, and this manual was
     written by	Luke Mewburn, with some	sections inspired by tcsh(1).

BSD			       January 11, 1997				   BSD


Want to link to this manual page? Use this URL:

home | help