From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Emilio Lopes Newsgroups: gmane.emacs.devel Subject: update of emacsclient.1 Date: Wed, 17 Aug 2005 12:32:03 +0200 Organization: private Message-ID: <8t64u4vopo.fsf@tiscali.de> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1124276135 1002 80.91.229.2 (17 Aug 2005 10:55:35 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Wed, 17 Aug 2005 10:55:35 +0000 (UTC) Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Aug 17 12:55:30 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1E5LZ3-0003bK-HN for ged-emacs-devel@m.gmane.org; Wed, 17 Aug 2005 12:54:33 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1E5LcV-0002nN-Py for ged-emacs-devel@m.gmane.org; Wed, 17 Aug 2005 06:58:08 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1E5LbF-0002Xv-9i for emacs-devel@gnu.org; Wed, 17 Aug 2005 06:56:49 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1E5LbA-0002WO-3j for emacs-devel@gnu.org; Wed, 17 Aug 2005 06:56:45 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1E5Lb8-0002VQ-Mr for emacs-devel@gnu.org; Wed, 17 Aug 2005 06:56:43 -0400 Original-Received: from [80.91.229.2] (helo=ciao.gmane.org) by monty-python.gnu.org with esmtp (TLS-1.0:RSA_AES_128_CBC_SHA:16) (Exim 4.34) id 1E5LmN-0007uQ-Nu for emacs-devel@gnu.org; Wed, 17 Aug 2005 07:08:20 -0400 Original-Received: from root by ciao.gmane.org with local (Exim 4.43) id 1E5LUz-0002RQ-Q4 for emacs-devel@gnu.org; Wed, 17 Aug 2005 12:50:21 +0200 Original-Received: from p62.246.54.45.tisdip.tiscali.de ([62.246.54.45]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Wed, 17 Aug 2005 12:50:21 +0200 Original-Received: from eclig by p62.246.54.45.tisdip.tiscali.de with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Wed, 17 Aug 2005 12:50:21 +0200 X-Injected-Via-Gmane: http://gmane.org/ Original-To: emacs-devel@gnu.org Original-Lines: 124 Original-X-Complaints-To: usenet@sea.gmane.org X-Gmane-NNTP-Posting-Host: p62.246.54.45.tisdip.tiscali.de User-Agent: Emacs Gnus Cancel-Lock: sha1:D4qHjzop3rs2dxgUF5pGFKkS/os= X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:42173 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:42173 enclosed is a patch updating the man page of Emacsclient. I hope the changes are appropriate. I have one question though. Under "DESCRIPTION" it says: You typically do not call emacsclient directly. Instead, you set the environment variable EDITOR to emacsclient and let programs like 'vipw' or 'bug' or anything run it for you, which will use an existing Emacs to visit the file. I myself call `emacsclient' often from the shell. And should these `vipw' and `bug' programs be really mentioned? I use Debian GNU/Linux, the system for which the man page was originally written, but I don't have this `bug' program. What people think of changing the above paragraph to You can either call emacsclient directly or set the environment variable EDITOR to 'emacsclient' and let other programs run it for you, thus using an existing Emacs to edit the file. ? Here is the patch: 2005-08-17 Emilio C. Lopes * emacsclient.1 (DESCRIPTION): reflect inclusion in the Emacs distribution. (OPTIONS): documented `-s', `-V' and `-h' as well as their long name counterparts. (BUGS): removed since its contents doesn't apply anymore. diff -rN -c old-emacs-darcs.eclig/etc/emacsclient.1 new-emacs-darcs.eclig/etc/emacsclient.1 *** old-emacs-darcs.eclig/etc/emacsclient.1 Wed Aug 17 12:27:14 2005 --- new-emacs-darcs.eclig/etc/emacsclient.1 Wed Aug 17 12:18:48 2005 *************** *** 9,21 **** .SH "DESCRIPTION" This manual page documents briefly the .BR emacsclient ! command. ! This manual page was written for the Debian GNU/Linux distribution ! because the original program does not have a manual page. ! Instead, it has documentation in the GNU Info format; see below. .PP .B emacsclient ! works in conjunction with the built-in server of Emacs. .PP You typically do not call .B emacsclient --- 9,21 ---- .SH "DESCRIPTION" This manual page documents briefly the .BR emacsclient ! command. Full documentation is available in the GNU Info format; see ! below. ! This manual page was originally written for the Debian GNU/Linux ! distribution, but is not specific to that system. .PP .B emacsclient ! works in conjunction with the built-in Emacs server. .PP You typically do not call .B emacsclient *************** *** 54,79 **** do not visit files but instead evaluate the arguments as Emacs Lisp expressions. .TP .B \-a, \-\-alternate-editor=EDITOR if the Emacs server is not running, run the specified editor instead. This can also be specified via the `ALTERNATE_EDITOR' environment variable. .TP .B \-d, \-\-display=DISPLAY tell the server to display the files on the given display. .SH "SEE ALSO" 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 , ! for the Debian GNU/Linux system (but may be used by others). .SH COPYING This manual page is in the public domain. --- 54,81 ---- do not visit files but instead evaluate the arguments as Emacs Lisp expressions. .TP + .B \-s, \-\-socket-name=FILENAME + Use socket named FILENAME for communication. + .TP .B \-a, \-\-alternate-editor=EDITOR if the Emacs server is not running, run the specified editor instead. This can also be specified via the `ALTERNATE_EDITOR' environment variable. .TP .B \-d, \-\-display=DISPLAY tell the server to display the files on the given display. + .TP + .B \-V, \-\-version + print version information and exit + .TP + .B \-h, \-\-help + print this usage information message and exit .SH "SEE ALSO" The program is documented fully in .IR "Using Emacs as a Server" available via the Info system. .SH AUTHOR This manual page was written by Stephane Bortzmeyer , ! for the Debian GNU/Linux system. .SH COPYING This manual page is in the public domain.