Mercurial > emacs
annotate etc/emacsclient.1 @ 57051:59091995520c
(msdos.o): Depend on buffer.h, commands.h, and
blockinput.h.
(dosfns.o): Depend on blockinput.h, window.h, dispextern.h,
charset.h, and coding.h
(w16select.o): Depend on buffer.h, charset.h, coding.h, and
composite.h.
(term.o): Depend on window.h and keymap.h.
(abbrev.o): Depend on syntax.h.
(callint.o): Depend on keymap.h.
(casefiddle.o): Depend on charset.h and keymap.h.
(category.o): Depend on keymap.h.
(coding.o): Depend on dispextern.h.
(cmds.o): Depend on keyboard.h and keymap.h.
(dispnew.o): Depend on indent.h and intervals.h.
(doc.o): Depend on keymap.h.
(editfns.o): Depend on frame.h.
(emacs.o): Depend on dispextern.h.
(fileio.o): Don't depend on ccl.h.
(filelock.o): Depend on charset.h and coding.h.
(frame.o): Depend on w32term.h and macterm.h.
(insdel.o): Depend on region-cache.h.
(keyboard.o): Depend on keymap.h, w32term.h, and macterm.h.
(minibuf.o): Depend on $(INTERVALS_SRC) and keymap.h.
(search.o): Depend on $(INTERVALS_SRC).
(syntax.o): Depend on keymap.h, regex.h, and $(INTERVALS_SRC).
(window.o): Depend on keymap.h, blockinput.h, $(INTERVALS_SRC),
xterm.h, w32term.h, and macterm.h.
(xdisp.o): Depend on keyboard.h, $(INTERVALS_SRC), xterm.h,
w32term.h, and macterm.h.
(xfaces.o): Depend on keyboard.h, $(INTERVALS_SRC),
region-cache.h, xterm.h, w32term.h, and macterm.h.
(bytecode.o): Depend on dispextern.h, frame.h, and xterm.h.
(data.o): Depend on frame.h.
(fns.o): Depend on keymap.h, xterm.h, and blockinput.h.
(print.o): Depend on termchar.h and $(INTERVALS_SRC).
(lread.o): Depend on $(INTERVALS_SRC), termhooks.h, and coding.h.
(intervals.o): Depend on keymap.h.
author | Eli Zaretskii <eliz@gnu.org> |
---|---|
date | Fri, 10 Sep 2004 18:16:57 +0000 |
parents | 695cf19ef79e |
children | 19477c8eacc2 375f2633d815 |
rev | line source |
---|---|
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>
parents:
37560
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>
parents:
37560
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>
parents:
37560
diff
changeset
|
52 .TP |
3b27be508d4e
Add info about --eval, --display, and --alternate-editor.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
37560
diff
changeset
|
53 .B \-e, \-\-eval |
3b27be508d4e
Add info about --eval, --display, and --alternate-editor.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
37560
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>
parents:
37560
diff
changeset
|
55 Lisp expressions. |
3b27be508d4e
Add info about --eval, --display, and --alternate-editor.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
37560
diff
changeset
|
56 .TP |
3b27be508d4e
Add info about --eval, --display, and --alternate-editor.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
37560
diff
changeset
|
57 .B \-a, \-\-alternate-editor=EDITOR |
3b27be508d4e
Add info about --eval, --display, and --alternate-editor.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
37560
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>
parents:
37560
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>
parents:
37560
diff
changeset
|
60 .TP |
3b27be508d4e
Add info about --eval, --display, and --alternate-editor.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
37560
diff
changeset
|
61 .B \-d, \-\-display=DISPLAY |
3b27be508d4e
Add info about --eval, --display, and --alternate-editor.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
37560
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. | |
52401 | 79 |
80 .\" arch-tag: 2b35e723-b197-4073-8752-231bc8b3d3f3 |