From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stephen Berman Newsgroups: gmane.emacs.bugs,gmane.emacs.pretest.bugs Subject: bug#3806: 23.1.50; rename-uniquely doc Date: Fri, 10 Jul 2009 11:27:27 +0200 Message-ID: <87bpnsevls.fsf@escher.local.home> Reply-To: Stephen Berman , 3806@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1247218986 29680 80.91.229.12 (10 Jul 2009 09:43:06 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 10 Jul 2009 09:43:06 +0000 (UTC) To: emacs-pretest-bug@gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Jul 10 11:42:59 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 1MPCcy-0001Y9-C6 for geb-bug-gnu-emacs@m.gmane.org; Fri, 10 Jul 2009 11:42:48 +0200 Original-Received: from localhost ([127.0.0.1]:34519 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MPCcx-00019R-QY for geb-bug-gnu-emacs@m.gmane.org; Fri, 10 Jul 2009 05:42:47 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MPCXx-0003vT-5h for bug-gnu-emacs@gnu.org; Fri, 10 Jul 2009 05:37:37 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MPCXr-0003md-6q for bug-gnu-emacs@gnu.org; Fri, 10 Jul 2009 05:37:35 -0400 Original-Received: from [199.232.76.173] (port=39498 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MPCXq-0003mO-Hx for bug-gnu-emacs@gnu.org; Fri, 10 Jul 2009 05:37:30 -0400 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:46444) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1MPCXq-000284-0q for bug-gnu-emacs@gnu.org; Fri, 10 Jul 2009 05:37:30 -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 n6A9bQFR006500; Fri, 10 Jul 2009 02:37:27 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.14.3/8.14.3/Submit) id n6A9Z5JH005883; Fri, 10 Jul 2009 02:35:05 -0700 X-Loop: owner@emacsbugs.donarmstrong.com Resent-From: Stephen Berman Original-Sender: steve@escher.local.home Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs Resent-Date: Fri, 10 Jul 2009 09:35:05 +0000 Resent-Message-ID: Resent-Sender: owner@emacsbugs.donarmstrong.com X-Emacs-PR-Message: report 3806 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Original-Received: via spool by submit@emacsbugs.donarmstrong.com id=B.12472180614963 (code B ref -1); Fri, 10 Jul 2009 09:35:05 +0000 Original-Received: (at submit) by emacsbugs.donarmstrong.com; 10 Jul 2009 09:27:41 +0000 X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. Original-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 n6A9RajD004958 for ; Fri, 10 Jul 2009 02:27:37 -0700 Original-Received: from mx10.gnu.org ([199.232.76.166]:35072) by fencepost.gnu.org with esmtp (Exim 4.67) (envelope-from ) id 1MPCOF-00048o-7N for emacs-pretest-bug@gnu.org; Fri, 10 Jul 2009 05:27:35 -0400 Original-Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim 4.60) (envelope-from ) id 1MPCOD-0000Bb-8V for emacs-pretest-bug@gnu.org; Fri, 10 Jul 2009 05:27:35 -0400 Original-Received: from mail.gmx.net ([213.165.64.20]:46950) by monty-python.gnu.org with smtp (Exim 4.60) (envelope-from ) id 1MPCOC-0000AZ-KM for emacs-pretest-bug@gnu.org; Fri, 10 Jul 2009 05:27:33 -0400 Original-Received: (qmail invoked by alias); 10 Jul 2009 09:27:29 -0000 Original-Received: from i59F57C5D.versanet.de (EHLO escher.local.home) [89.245.124.93] by mail.gmx.net (mp038) with SMTP; 10 Jul 2009 11:27:29 +0200 X-Authenticated: #20778731 X-Provags-ID: V01U2FsdGVkX1+FoatrFJyFRZcOiKjxu2cf+B94oqloi8szvpnMvI eeTRq/7I4+NEfC Original-Received: by escher.local.home (Postfix, from userid 1000) id 3758B1D152F; Fri, 10 Jul 2009 11:27:28 +0200 (CEST) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.1.50 (gnu/linux) X-Y-GMX-Trusted: 0 X-FuHaFi: 0.48 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 3) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 2) Resent-Date: Fri, 10 Jul 2009 05:37:35 -0400 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:29294 gmane.emacs.pretest.bugs:24759 Archived-At: The doc string of rename-uniquely says: ,---- | Rename current buffer to a similar name not already taken. | This function is useful for creating multiple shell process buffers | or multiple mail buffers, etc. `---- The Emacs manual (node Misc Buffer) says more: ,---- | `M-x rename-uniquely' renames the current buffer to a similar name | with a numeric suffix added to make it both different and unique. This | command does not need an argument. It is useful for creating multiple | shell buffers: if you rename the `*shell*' buffer, then do `M-x shell' | again, it makes a new shell buffer named `*shell*'; meanwhile, the old | shell buffer continues to exist under its new name. This method is | also good for mail buffers, compilation buffers, and most Emacs | features that create special buffers with particular names. (With some | of these features, such as `M-x compile', `M-x grep' an `M-x info', you | need to switch to some other buffer before using the command, in order | for it to make a different buffer.) `---- The last, parenthetical, sentence in particular is important information, and I think it should also be in the doc string, since this is an annoying gotcha. And for this reason, I also think it should be more specific, not just listing "some of these features" that require switching out of the uniquely renamed buffer, but all such known "features". However, the manual appears to be out of date, or just inaccurate: invoking Info from within a uniquely renamed Info buffer does not overwrite it but opens new Info buffer, as I just confirmed with -Q. So the doc needs to be at least corrected (and preferably augmented). If `M-x info' has indeed been "fixed" wrt rename-uniquely, then can't `M-x {r,l}grep' and `M-x compile' likewise be fixed? (I haven't tested compile for this, but the grep commands do indeed, annoyingly, require switching buffers.) Since the requirement is documented, it is not strictly a bug, but the behavior is suboptimal and if, as with Info, it can be changed, then I think it should be. I can submit a separate bug for that. In GNU Emacs 23.1.50.3 (i686-pc-linux-gnu, GTK+ Version 2.14.4) of 2009-07-08 on escher Windowing system distributor `The X.Org Foundation', version 11.0.10502000 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: en_US.UTF-8 value of $XMODIFIERS: @im=local locale-coding-system: utf-8-unix default-enable-multibyte-characters: t