Penguin
Blame: emacsclient(1)
EditPageHistoryDiffInfoLikePages
Annotated edit history of emacsclient(1) version 1 showing authors affecting page license. View with all changes included.
Rev Author # Line
1 perry 1 EMACSCLIENT
2 !!!EMACSCLIENT
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 SEE ALSO
8 BUGS
9 AUTHOR
10 ----
11 !!NAME
12
13
14 emacsclient - tells a running Emacs to visit a file
15 !!SYNOPSIS
16
17
18 __emacsclient__ ''[[options] files ...''
19 !!DESCRIPTION
20
21
22 This manual page documents briefly the __emacsclient__
23 command. This manual page was written for the Debian
24 GNU/Linux distribution because the original program does not
25 have a manual page. Instead, it has documentation in the GNU
26 Info format; see below.
27
28
29 __emacsclient__ works in conjunction with the built-in
30 server of Emacs.
31
32
33 You typically does not call __emacsclient__ directly.
34 Instead, you set the environment variable EDITOR to
35 __emacsclient__ and let programs like 'vipw' or 'bug' or
36 anything run it for you, which will use an existing Emacs to
37 visit the file.
38
39
40 For __emacsclient__ to work, you need an already running
41 Emacs with a server. Within Emacs, call the function
42 `server-start'. (Your `.emacs' file can do this
43 automatically if you add the expression `(server-start)' to
44 it.)
45
46
47 When you've finished editing the buffer, type `C-x #'
48 (`server-edit'). This saves the file and sends a message
49 back to the `emacsclient' program telling it to exit. The
50 programs that use `EDITOR' wait for the
51
52
53 If you set the variable `server-window' to a window or a
54 frame, `C-x #' displays the server buffer in that window or
55 in that frame.
56 !!OPTIONS
57
58
59 The programs follow the usual GNU command line syntax, with
60 long options starting with two dashes (`-').
61
62
63 __-n, --no-wait__
64
65
66 returns immediately without waiting for you to
67 !!SEE ALSO
68
69
70 The program is documented fully in ''Using Emacs as a
71 Server'' available via the Info system.
72 !!BUGS
73
74
75 If there is no running Emacs server, __emacsclient__
76 cannot launch one. I use a small Perl script instead of raw
77 __emacsclient__ to do it (it works only with systems
78 which have BSD sockets, which is fine for Debian
79 GNU/Linux).
80 !!AUTHOR
81
82
83 This manual page was written by Stephane Bortzmeyer
84 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.