X-Git-Url: http://git.hcoop.net/bpt/emacs.git/blobdiff_plain/4c14013dbec3a2f130a38e61e885f1e8cc6c325b..be520aca79dd429d55012a1916bdc97f06773fc5:/doc/emacs/misc.texi diff --git a/doc/emacs/misc.texi b/doc/emacs/misc.texi index 11d6ad70e6..290e5dc53b 100644 --- a/doc/emacs/misc.texi +++ b/doc/emacs/misc.texi @@ -1,6 +1,5 @@ @c This is part of the Emacs manual. -@c Copyright (C) 1985, 1986, 1987, 1993, 1994, 1995, 1997, 2000, 2001, -@c 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 +@c Copyright (C) 1985-1987, 1993-1995, 1997, 2000-2011 @c Free Software Foundation, Inc. @c See file emacs.texi for copying conditions. @iftex @@ -27,28 +26,39 @@ other editors, and various diversions and amusements. @cindex PDF file @cindex PS file @cindex Postscript file +@cindex OpenDocument file +@cindex Microsoft Office file @cindex DocView mode @cindex mode, DocView @cindex document viewer (DocView) @findex doc-view-mode DocView mode (@code{doc-view-mode}) is a viewer for DVI, Postscript -(PS), and PDF documents. It provides features such as slicing, -zooming, and searching inside documents. It works by converting the -document to a set of images using the @command{gs} (GhostScript) -command, and displaying those images. +(PS), PDF, OpenDocument, and Microsoft Office documents. It provides +features such as slicing, zooming, and searching inside documents. It +works by converting the document to a set of images using the +@command{gs} (GhostScript) command and other external tools +@footnote{@code{gs} is a hard requirement. For DVI files, +@code{dvipdf} or @code{dvipdfm} is needed. For OpenDocument and +Microsoft Office documents, the @code{unoconv} tool is needed.}, and +displaying those images. @findex doc-view-toggle-display @findex doc-view-toggle-display @cindex doc-view-minor-mode - When you visit a PDF or DVI file, Emacs automatically switches to -DocView mode. When you visit a Postscript file, Emacs switches to PS -mode, a major mode for editing Postscript files as text; however, it -also enables DocView minor mode, so you can type @kbd{C-c C-c} to view -the document with DocView. (PDF and DVI files, unlike Postscript -files, are not usually human-editable.) In either case, repeating -@kbd{C-c C-c} (@code{doc-view-toggle-display}) toggles between DocView -and the file text. + When you visit a document file with the exception of Postscript +files, Emacs automatically switches to DocView mode if possible +@footnote{The needed external tools for this document type have to be +available, emacs needs to run in a graphical frame, and PNG image +support has to be compiled into emacs. If any of these requirements +is not fulfilled, DocView falls back to an appropriate mode.}. When +you visit a Postscript file, Emacs switches to PS mode, a major mode +for editing Postscript files as text; however, it also enables DocView +minor mode, so you can type @kbd{C-c C-c} to view the document with +DocView. (PDF and DVI files, unlike Postscript files, are not usually +human-editable.) In either case, repeating @kbd{C-c C-c} +(@code{doc-view-toggle-display}) toggles between DocView and the file +text. You can explicitly toggle DocView mode with the command @code{M-x doc-view-mode}, and DocView minor mode with the command @code{M-x @@ -1485,6 +1495,15 @@ server-name @key{RET} foo @key{RET}} sets the server name to @samp{foo}. The @code{emacsclient} program can specify a server by name, using the @samp{-s} option (@pxref{emacsclient Options}). +@findex server-eval-at + If you have defined a server by a unique server name, you can +connect to this server from other Emacs instances and evaluate forms +on it by using the @code{server-eval-at} function. + +@code{(server-eval-at "foo" '(+ 1 2))} gives the result @code{3}, if +there's a server with that name that is listening. If not, an error +will be signaled. + @menu * Invoking emacsclient:: Connecting to the Emacs server. * emacsclient Options:: Emacs client startup options. @@ -1584,16 +1603,8 @@ listed below: @item -a @var{command} @itemx --alternate-editor=@var{command} Specify a command to run if @code{emacsclient} fails to contact Emacs. -This is useful when running @code{emacsclient} in a script. For -example, the following setting for the @env{EDITOR} environment -variable will always give you an editor, even if no Emacs server is -running: - -@example -EDITOR="emacsclient --alternate-editor emacs +%d %s" -@end example +This is useful when running @code{emacsclient} in a script. -@noindent As a special exception, if @var{command} is the empty string, then @code{emacsclient} starts Emacs in daemon mode and then tries connecting again. @@ -1662,6 +1673,11 @@ all server buffers are finished. You can take as long as you like to edit the server buffers within Emacs, and they are @emph{not} killed when you type @kbd{C-x #} in them. +@item -q +@itemx --quiet +Do not let @command{emacsclient} display messages about waiting for +Emacs or connecting to remote server sockets. + @item -s @var{server-name} @itemx --socket-name=@var{server-name} Connect to the Emacs server named @var{server-name}. The server name @@ -2489,9 +2505,8 @@ also use the command @kbd{M-x scroll-all-mode} or set the variable @item EDT (DEC VMS editor) @findex edt-emulation-on @findex edt-emulation-off -Turn on EDT emulation with the command @kbd{M-x edt-emulation-on}, -while @kbd{M-x edt-emulation-off} restores normal Emacs command -bindings. +Turn on EDT emulation @kbd{M-x edt-emulation-on}; use @kbd{M-x +edt-emulation-off} to restore normal Emacs command bindings. Most of the EDT emulation commands are keypad keys, and most standard Emacs key bindings are still available. The EDT emulation rebindings @@ -2872,7 +2887,3 @@ idle. @ifnottex @lowersections @end ifnottex - -@ignore - arch-tag: 8f094220-c0d5-4e9e-af7d-3e0da8187474 -@end ignore