tags 268627 + patch thank you Hello.
What BUGS section details can well be done with the -a switch already in there. Just set as your editor "emacsclient -a emacs" and you'll get a new emacs whenever connecting to the server fails. The -a option is not mentioned in the emacsclient man page. A patch attached that adds that to there, as well as a description of the +line:column argument to set line and column numbers. There's one typo fix in there, too.
diff -ur emacs21-21.4a.orig/etc/emacsclient.1 emacs21-21.4a/etc/emacsclient.1 --- emacs21-21.4a.orig/etc/emacsclient.1 2001-05-04 10:13:05.000000000 +0300 +++ emacs21-21.4a/etc/emacsclient.1 2005-09-03 23:48:06.708599246 +0300 @@ -5,7 +5,10 @@ emacsclient \- tells a running Emacs to visit a file .SH SYNOPSIS .B emacsclient -.I "[options] files ..." +.RB [ -a +.IR alternate-editor ] +.RB [ -n | --no-wait ] +.RI ([+ line [: column ]]\ file )... .SH "DESCRIPTION" This manual page documents briefly the .BR emacsclient @@ -17,7 +20,7 @@ .B emacsclient works in conjunction with the built-in server of Emacs. .PP -You typically does not call +You typically do not call .B emacsclient directly. Instead, you set the environment variable EDITOR to @@ -42,10 +45,22 @@ 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. +You can set the line and column to set the cursor to in the edited +file with the optional +.BI + line [: column ] +argument. + .SH OPTIONS The programs follow the usual GNU command line syntax, with long options starting with two dashes (`-'). .TP +.BI \-a \ alternate-editor +runs +.I alternate-editor +if emacsclient fails to connect to an Emacs. Without this option +.B emacsclient +returns with an error on failure. +.TP .B \-n, \-\-no-wait returns immediately without waiting for you to "finish" the buffer in Emacs. @@ -53,13 +68,6 @@ The program is documented fully in .IR "Using Emacs as a Server" available via the Info system. -.SH BUGS -If there is no running Emacs server, -.B emacsclient -cannot launch one. I use a small Perl script instead of raw -.B emacsclient -to do it (it works only with systems which have BSD sockets, which is fine -for Debian GNU/Linux). .SH AUTHOR This manual page was written by Stephane Bortzmeyer <[EMAIL PROTECTED]>, for the Debian GNU/Linux system (but may be used by others). Only in emacs21-21.4a/etc/: emacsclient.1~
