25853
|
1 .TH EMACSCLIENT 1
|
|
2 .\" NAME should be all caps, SECTION should be 1-8, maybe w/ subsection
|
|
3 .\" other parms are allowed: see man(7), man(1)
|
|
4 .SH NAME
|
|
5 emacsclient \- tells a running Emacs to visit a file
|
|
6 .SH SYNOPSIS
|
|
7 .B emacsclient
|
|
8 .I "[options] files ..."
|
|
9 .SH "DESCRIPTION"
|
|
10 This manual page documents briefly the
|
|
11 .BR emacsclient
|
|
12 command.
|
|
13 This manual page was written for the Debian GNU/Linux distribution
|
|
14 because the original program does not have a manual page.
|
|
15 Instead, it has documentation in the GNU Info format; see below.
|
|
16 .PP
|
|
17 .B emacsclient
|
|
18 works in conjunction with the built-in server of Emacs.
|
|
19 .PP
|
47649
3b27be508d4e
Add info about --eval, --display, and --alternate-editor.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
20 You typically do not call
|
25853
|
21 .B emacsclient
|
47649
3b27be508d4e
Add info about --eval, --display, and --alternate-editor.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
22 directly. Instead, you set the environment variable EDITOR
|
25853
|
23 to
|
|
24 .B emacsclient
|
|
25 and let programs like 'vipw' or 'bug' or anything run
|
|
26 it for you, which will use an existing Emacs to visit the file.
|
|
27
|
|
28 For
|
|
29 .B emacsclient
|
|
30 to work, you need an already running Emacs with a server. Within Emacs, call
|
|
31 the function
|
|
32 `server-start'. (Your `.emacs' file can do this automatically if you
|
|
33 add the expression `(server-start)' to it.)
|
|
34
|
|
35 When you've finished editing the buffer, type `C-x #'
|
|
36 (`server-edit'). This saves the file and sends a message back to the
|
|
37 `emacsclient' program telling it to exit. The programs that use
|
|
38 `EDITOR' wait for the "editor" (actually, `emacsclient') to exit. `C-x
|
|
39 #' also checks for other pending external requests to edit various
|
|
40 files, and selects the next such file.
|
|
41
|
|
42 If you set the variable `server-window' to a window or a frame, `C-x
|
|
43 #' displays the server buffer in that window or in that frame.
|
|
44
|
|
45 .SH OPTIONS
|
|
46 The programs follow the usual GNU command line syntax, with long
|
|
47 options starting with two dashes (`-').
|
|
48 .TP
|
|
49 .B \-n, \-\-no-wait
|
|
50 returns
|
|
51 immediately without waiting for you to "finish" the buffer in Emacs.
|
47649
3b27be508d4e
Add info about --eval, --display, and --alternate-editor.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
52 .TP
|
3b27be508d4e
Add info about --eval, --display, and --alternate-editor.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
53 .B \-e, \-\-eval
|
3b27be508d4e
Add info about --eval, --display, and --alternate-editor.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
54 do not visit files but instead evaluate the arguments as Emacs
|
3b27be508d4e
Add info about --eval, --display, and --alternate-editor.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
55 Lisp expressions.
|
3b27be508d4e
Add info about --eval, --display, and --alternate-editor.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
56 .TP
|
3b27be508d4e
Add info about --eval, --display, and --alternate-editor.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
57 .B \-a, \-\-alternate-editor=EDITOR
|
3b27be508d4e
Add info about --eval, --display, and --alternate-editor.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
58 if the Emacs server is not running, run the specified editor instead.
|
3b27be508d4e
Add info about --eval, --display, and --alternate-editor.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
59 This can also be specified via the `ALTERNATE_EDITOR' environment variable.
|
3b27be508d4e
Add info about --eval, --display, and --alternate-editor.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
60 .TP
|
3b27be508d4e
Add info about --eval, --display, and --alternate-editor.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
61 .B \-d, \-\-display=DISPLAY
|
3b27be508d4e
Add info about --eval, --display, and --alternate-editor.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
62 tell the server to display the files on the given display.
|
25853
|
63 .SH "SEE ALSO"
|
|
64 The program is documented fully in
|
|
65 .IR "Using Emacs as a Server"
|
|
66 available via the Info system.
|
|
67 .SH BUGS
|
|
68 If there is no running Emacs server,
|
|
69 .B emacsclient
|
|
70 cannot launch one. I use a small Perl script instead of raw
|
|
71 .B emacsclient
|
|
72 to do it (it works only with systems which have BSD sockets, which is fine
|
|
73 for Debian GNU/Linux).
|
|
74 .SH AUTHOR
|
|
75 This manual page was written by Stephane Bortzmeyer <bortzmeyer@debian.org>,
|
|
76 for the Debian GNU/Linux system (but may be used by others).
|
37560
|
77 .SH COPYING
|
|
78 This manual page is in the public domain.
|