From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: owner@emacsbugs.donarmstrong.com (Emacs bug Tracking System) Newsgroups: gmane.emacs.bugs Subject: bug#4419: marked as done (23.1.50; Emacs manual "Invoking `emacsclient'" is unclear) Date: Fri, 18 Sep 2009 23:50:12 +0000 Message-ID: References: <87k4zvom11.fsf@stupidchicken.com> <83vdjozcm8.fsf@gnu.org> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="----------=_1253317812-29981-0" X-Trace: ger.gmane.org 1253318857 17508 80.91.229.12 (19 Sep 2009 00:07:37 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 19 Sep 2009 00:07:37 +0000 (UTC) To: Chong Yidong Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Sep 19 02:07:30 2009 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1MonU9-0001hc-JA for geb-bug-gnu-emacs@m.gmane.org; Sat, 19 Sep 2009 02:07:30 +0200 Original-Received: from localhost ([127.0.0.1]:35049 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MonU9-0005U4-2N for geb-bug-gnu-emacs@m.gmane.org; Fri, 18 Sep 2009 20:07:29 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MonTs-0005Nr-Il for bug-gnu-emacs@gnu.org; Fri, 18 Sep 2009 20:07:13 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MonTn-0005MX-MQ for bug-gnu-emacs@gnu.org; Fri, 18 Sep 2009 20:07:11 -0400 Original-Received: from [199.232.76.173] (port=39963 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MonTn-0005MQ-IB for bug-gnu-emacs@gnu.org; Fri, 18 Sep 2009 20:07:07 -0400 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:46872) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1MonTm-0007Ma-6J for bug-gnu-emacs@gnu.org; Fri, 18 Sep 2009 20:07:06 -0400 Original-Received: from rzlab.ucr.edu (rzlab.ucr.edu [127.0.0.1]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n8J072DP000777; Fri, 18 Sep 2009 17:07:03 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.14.3/8.14.3/Submit) id n8INoCJO030015; Fri, 18 Sep 2009 16:50:12 -0700 X-Mailer: MIME-tools 5.427 (Entity 5.427) X-Loop: owner@emacsbugs.donarmstrong.com X-Emacs-PR-Message: closed 4419 X-Emacs-PR-Package: emacs X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 2) X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:31265 Archived-At: This is a multi-part message in MIME format... ------------=_1253317812-29981-0 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset=utf-8 Your message dated Fri, 18 Sep 2009 19:44:58 -0400 with message-id <87k4zvom11.fsf@stupidchicken.com> and subject line Re: 23.1.50; Emacs manual "Invoking `emacsclient'" is uncl= ear has caused the Emacs bug report #4419, regarding 23.1.50; Emacs manual "Invoking `emacsclient'" is unclear to be marked as done. This means that you claim that the problem has been dealt with. If this is not the case it is now your responsibility to reopen the bug report if necessary, and/or fix the problem forthwith. (NB: If you are a system administrator and have no idea what this message is talking about, this may indicate a serious mail system misconfiguration somewhere. Please contact owner@emacsbugs.donarmstrong.com immediately.) --=20 4419: http://emacsbugs.donarmstrong.com/cgi-bin/bugreport.cgi?bug=3D4419 Emacs Bug Tracking System Contact owner@emacsbugs.donarmstrong.com with problems ------------=_1253317812-29981-0 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by emacsbugs.donarmstrong.com; 12 Sep 2009 10:22:30 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=-1.4 required=4.0 tests=AWL,FOURLA autolearn=no version=3.2.5-bugs.debian.org_2005_01_02 Received: from fencepost.gnu.org (fencepost.gnu.org [140.186.70.10]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n8CAMTVJ008314 for ; Sat, 12 Sep 2009 03:22:30 -0700 Received: from mx10.gnu.org ([199.232.76.166]:58386) by fencepost.gnu.org with esmtp (Exim 4.67) (envelope-from ) id 1MmPkS-00039g-Iy for emacs-pretest-bug@gnu.org; Sat, 12 Sep 2009 06:22:28 -0400 Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim 4.60) (envelope-from ) id 1MmPkQ-0004Ij-5S for emacs-pretest-bug@gnu.org; Sat, 12 Sep 2009 06:22:28 -0400 Received: from mtaout2.012.net.il ([84.95.2.4]:50875) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1MmPkP-0004Ia-IB for emacs-pretest-bug@gnu.org; Sat, 12 Sep 2009 06:22:26 -0400 Received: from conversion-daemon.i_mtaout2.012.net.il by i_mtaout2.012.net.il (HyperSendmail v2004.12) id <0KPU00B00SMZQW00@i_mtaout2.012.net.il> for emacs-pretest-bug@gnu.org; Sat, 12 Sep 2009 13:22:23 +0300 (IDT) Received: from HOME-C4E4A596F7 ([84.228.50.163]) by i_mtaout2.012.net.il (HyperSendmail v2004.12) with ESMTPA id <0KPU00D9WSTBRHE0@i_mtaout2.012.net.il> for emacs-pretest-bug@gnu.org; Sat, 12 Sep 2009 13:22:23 +0300 (IDT) Date: Sat, 12 Sep 2009 13:22:23 +0300 From: Eli Zaretskii Subject: 23.1.50; Emacs manual "Invoking `emacsclient'" is unclear X-012-Sender: halo1@inter.net.il To: emacs-pretest-bug@gnu.org Reply-to: Eli Zaretskii Message-id: <83vdjozcm8.fsf@gnu.org> X-detected-operating-system: by monty-python.gnu.org: Solaris 9.1 Please write in English if possible, because the Emacs maintainers usually do not have translators to read other languages for them. Your bug report will be posted to the emacs-pretest-bug@gnu.org mailing list. Please describe exactly what actions triggered the bug and the precise symptoms of the bug: "(emacs) Invoking emacsclient" says: The simplest way to use the `emacsclient' program is to run the shell command `emacsclient FILE', where FILE is a file name. This connects to an Emacs server, and tells that Emacs process to visit FILE in one of its existing frames--either a graphical frame, or one in a text-only terminal (*note Frames::). You can then select that frame to begin editing. If there is no Emacs server, the `emacsclient' program halts with an error message. If the Emacs process has no existing frame--which can happen if it was started as a daemon (*note Emacs Server::)--then Emacs opens a frame on the terminal in which you called `emacsclient', as though you had used the `-t' option (*note emacsclient Options::). On a graphical display, switching to the Emacs server is straightforward--just select its (system-level) window. If you are using a text-only terminal, there are two ways to switch between `emacsclient''s shell and the Emacs server: (i) run the Emacs server and `emacsclient' on different virtual terminals, and switch to the Emacs server's virtual terminal after calling `emacsclient'; or (ii) call `emacsclient' from within the Emacs server itself, using Shell mode (*note Interactive Shell::) or Term mode (*note Term Mode::); `emacsclient' blocks only the subshell under Emacs, and you can still use Emacs to edit the file. This description has several problems: . The last paragraph explains how to ``switch to the Emacs server''. It does not explain what does it mean, nor why would the user want to do that, after invoking emacsclient. I'm guessing this text wants to tell how to switch to an existing frame where FILE is displayed; if this is true, the text should say that explicitly, since ``switching to the server'' is not something the user would necessarily think of as useful. In particular, the first paragraph correctly says ``you can then select that frame to begin editing'', so the last paragraph should pick up the same wording to indicate to the reader that it continues where the 1st left off. . AFAIU, if emacsclient is invoked with -t, the file will be displayed on the same terminal where emacsclient was invoked. This is by far more useful (and much less obscure) way of getting to the frame where FILE is displayed, so the text should mention that as well, or at least say that the next section describes this method. The last paragraph of this node, viz. If you set the variable `server-window' to a window or a frame, `C-x #' always displays the next server buffer in that window or in that frame. uses ambiguous wording: it took me a few moments to realize that by ``setting a variable to a window or a frame'' it means setting the _value_ of the variable. I would suggest rephrasing as follows: If the value of the variable `server-window' is a window or a frame, ... If Emacs crashed, and you have the Emacs process in the gdb debugger, please include the output from the following gdb commands: `bt full' and `xbacktrace'. If you would like to further debug the crash, please read the file d:/gnu/emacs/etc/DEBUG for instructions. In GNU Emacs 23.1.50.1 (i386-mingw-nt5.1.2600) of 2009-09-12 on HOME-C4E4A596F7 Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (3.4)' Important settings: value of $LC_ALL: nil value of $LC_COLLATE: nil value of $LC_CTYPE: nil value of $LC_MESSAGES: nil value of $LC_MONETARY: nil value of $LC_NUMERIC: nil value of $LC_TIME: nil value of $LANG: ENU value of $XMODIFIERS: nil locale-coding-system: cp1255 default enable-multibyte-characters: t Major mode: Info Minor modes in effect: tooltip-mode: t mouse-wheel-mode: t tool-bar-mode: t menu-bar-mode: t file-name-shadow-mode: t global-font-lock-mode: t font-lock-mode: t blink-cursor-mode: t global-auto-composition-mode: t auto-composition-mode: t auto-encryption-mode: t auto-compression-mode: t line-number-mode: t transient-mark-mode: t Recent input: C-u C-h i i n f e m a c s i e m a c s c l 1 M-x r e p o r t - e m Recent messages: For information about GNU Emacs and the GNU system, type C-h C-a. Found `emacsclient' in Concept Index. (3 total; use `,' for next) Load-path shadows: None found. > From: Stefan Monnier > Date: Sat, 12 Sep 2009 00:08:41 -0400 > > I'll leave the code as is, then. It's not like it's harmful. I commented out the call to custom-reevaluate-setting. > FWIW, I've just installed a few changes to handle such situations, which > should now be done by setting the defcustom's initializer to > custom-initialize-delay. I will add to my TODO to go through defcustoms for possible users of this facility. In general, any file name that violates DOS 8+3 limitations (e.g., starts with a period) and uses convert-standard-filename in its defcustom should use something like that, because what convert-standard-filename does depends on what the underlying filesystem, which could be different at dump time and at run time. ------------=_1253317812-29981-0 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 4419-done) by emacsbugs.donarmstrong.com; 18 Sep 2009 23:45:06 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=-0.4 required=4.0 tests=AWL autolearn=ham version=3.2.5-bugs.debian.org_2005_01_02 Received: from pantheon-po32.its.yale.edu (pantheon-po32.its.yale.edu [130.132.50.88]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n8INj4B3028972 for <4419-done@emacsbugs.donarmstrong.com>; Fri, 18 Sep 2009 16:45:05 -0700 Received: from furry (dhcp128036014244.central.yale.edu [128.36.14.244]) (authenticated bits=0) by pantheon-po32.its.yale.edu (8.12.11.20060308/8.12.11) with ESMTP id n8INiwoq005337 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT) for <4419-done@emacsbugs.donarmstrong.com>; Fri, 18 Sep 2009 19:44:58 -0400 Received: by furry (Postfix, from userid 1000) id D520DC070; Fri, 18 Sep 2009 19:44:58 -0400 (EDT) From: Chong Yidong To: 4419-done@emacsbugs.donarmstrong.com Subject: Re: 23.1.50; Emacs manual "Invoking `emacsclient'" is unclear Date: Fri, 18 Sep 2009 19:44:58 -0400 Message-ID: <87k4zvom11.fsf@stupidchicken.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-YaleITSMailFilter: Version 1.2c (attachment(s) not renamed) I've fixed misc.texi according to the suggestions in this bug report. ------------=_1253317812-29981-0--