other versions
- wheezy 23.4+1-4
EMACSCLIENT(1) | General Commands Manual | EMACSCLIENT(1) |
NAME¶
emacsclient - tells a running Emacs to visit a fileSYNOPSIS¶
emacsclient [options] files ...DESCRIPTION¶
This manual page documents briefly the emacsclient command. Full documentation is available in the GNU Info format; see below. This manual page was originally written for the Debian GNU/Linux distribution, but is not specific to that system. emacsclient works in conjunction with the built-in Emacs server. You can either call emacsclient directly or let other programs run it for you when necessary. On GNU and Unix systems many programs consult the environment variable EDITOR (sometimes also VISUAL) to obtain the command used for editing. Thus, setting this environment variable to 'emacsclient' will allow these programs to use an already running Emacs for editing. Other operating systems might have their own methods for defining the default editor.OPTIONS¶
The programs follow the usual GNU command line syntax, with long options starting with two dashes (`-').- -a, --alternate-editor=EDITOR
- if the Emacs server is not running, run the specified editor instead. This can also be specified via the `ALTERNATE_EDITOR' environment variable. If the value of EDITOR is the empty string, then Emacs is started in daemon mode and emacsclient will try to connect to it.
- -c, --create-frame
- create a new frame instead of trying to use the current Emacs frame
- -d, --display=DISPLAY
- tell the server to display the files on the given display.
- -e, --eval
- do not visit files but instead evaluate the arguments as Emacs Lisp expressions.
- -f, --server-file=FILENAME
- use TCP configuration file FILENAME for communication. This can also be specified via the `EMACS_SERVER_FILE' environment variable.
- -n, --no-wait
- returns immediately without waiting for you to "finish" the buffer in Emacs.
- -nw, -t, --tty
- open a new Emacs frame on the current terminal
- -s, --socket-name=FILENAME
- use socket named FILENAME for communication.
- -V, --version
- print version information and exit
- -H, --help
- print this usage information message and exit