mirror of
https://git.savannah.gnu.org/git/emacs.git
synced 2024-12-03 08:30:09 +00:00
fef741ad68
Make role of EDITOR clearer. (OPTIONS): Document `-s', `-V' and `-h' as well as their long name counterparts. (BUGS): Remove.
85 lines
2.9 KiB
Groff
85 lines
2.9 KiB
Groff
.TH EMACSCLIENT 1
|
|
.\" NAME should be all caps, SECTION should be 1-8, maybe w/ subsection
|
|
.\" other parms are allowed: see man(7), man(1)
|
|
.SH NAME
|
|
emacsclient \- tells a running Emacs to visit a file
|
|
.SH SYNOPSIS
|
|
.B emacsclient
|
|
.I "[options] files ..."
|
|
.SH "DESCRIPTION"
|
|
This manual page documents briefly the
|
|
.BR 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.
|
|
.PP
|
|
.B emacsclient
|
|
works in conjunction with the built-in Emacs server.
|
|
.PP
|
|
You can either call
|
|
.B 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.
|
|
|
|
For
|
|
.B emacsclient
|
|
to work, you need an already running Emacs with a server. Within Emacs, call
|
|
the function
|
|
`server-start'. (Your `.emacs' file can do this automatically if you
|
|
add the expression `(server-start)' to it.)
|
|
|
|
When you've finished editing the buffer, type `C-x #'
|
|
(`server-edit'). This saves the file and sends a message back to the
|
|
`emacsclient' program telling it to exit. The programs that use
|
|
`EDITOR' wait for the "editor" (actually, `emacsclient') to exit. `C-x
|
|
#' also checks for other pending external requests to edit various
|
|
files, and selects the next such file.
|
|
|
|
If you set the variable `server-window' to a window or a frame, `C-x
|
|
#' displays the server buffer in that window or in that frame.
|
|
|
|
.SH OPTIONS
|
|
The programs follow the usual GNU command line syntax, with long
|
|
options starting with two dashes (`-').
|
|
.TP
|
|
.B \-n, \-\-no-wait
|
|
returns
|
|
immediately without waiting for you to "finish" the buffer in Emacs.
|
|
.TP
|
|
.B \-e, \-\-eval
|
|
do not visit files but instead evaluate the arguments as Emacs
|
|
Lisp expressions.
|
|
.TP
|
|
.B \-s, \-\-socket-name=FILENAME
|
|
Use socket named FILENAME for communication.
|
|
.TP
|
|
.B \-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.
|
|
.TP
|
|
.B \-d, \-\-display=DISPLAY
|
|
tell the server to display the files on the given display.
|
|
.TP
|
|
.B \-V, \-\-version
|
|
print version information and exit
|
|
.TP
|
|
.B \-h, \-\-help
|
|
print this usage information message and exit
|
|
.SH "SEE ALSO"
|
|
The program is documented fully in
|
|
.IR "Using Emacs as a Server"
|
|
available via the Info system.
|
|
.SH AUTHOR
|
|
This manual page was written by Stephane Bortzmeyer <bortzmeyer@debian.org>,
|
|
for the Debian GNU/Linux system (but may be used by others).
|
|
.SH COPYING
|
|
This manual page is in the public domain.
|
|
|
|
.\" arch-tag: 2b35e723-b197-4073-8752-231bc8b3d3f3
|