From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.devel Subject: RE: with-output-to-temp-buffer Date: Thu, 1 Jun 2006 17:29:54 -0700 Message-ID: References: NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: sea.gmane.org 1149208227 28465 80.91.229.2 (2 Jun 2006 00:30:27 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 2 Jun 2006 00:30:27 +0000 (UTC) Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Jun 02 02:30:19 2006 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1FlxYP-0002Q3-BV for ged-emacs-devel@m.gmane.org; Fri, 02 Jun 2006 02:30:17 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1FlxYO-0000fZ-Pw for ged-emacs-devel@m.gmane.org; Thu, 01 Jun 2006 20:30:16 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1FlxYD-0000fU-93 for emacs-devel@gnu.org; Thu, 01 Jun 2006 20:30:05 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1FlxYB-0000fA-WD for emacs-devel@gnu.org; Thu, 01 Jun 2006 20:30:05 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1FlxYB-0000f7-Sf for emacs-devel@gnu.org; Thu, 01 Jun 2006 20:30:03 -0400 Original-Received: from [141.146.126.228] (helo=agminet01.oracle.com) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_3DES_EDE_CBC_SHA:24) (Exim 4.52) id 1FlxeX-0002pi-M6 for emacs-devel@gnu.org; Thu, 01 Jun 2006 20:36:37 -0400 Original-Received: from rgmsgw300.us.oracle.com (rgmsgw300.us.oracle.com [138.1.186.49]) by agminet01.oracle.com (Switch-3.1.7/Switch-3.1.7) with ESMTP id k520U1oY025368 for ; Thu, 1 Jun 2006 19:30:02 -0500 Original-Received: from dradamslap (dhcp-amer-whq-csvpn-gw3-141-144-80-108.vpn.oracle.com [141.144.80.108]) by rgmsgw300.us.oracle.com (Switch-3.1.7/Switch-3.1.7) with SMTP id k520U0Td021367 (version=TLSv1/SSLv3 cipher=RC4-MD5 bits=128 verify=NO) for ; Thu, 1 Jun 2006 18:30:01 -0600 Original-To: "Emacs-Devel" X-Priority: 3 (Normal) X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook IMO, Build 9.0.6604 (9.0.2911.0) In-Reply-To: Importance: Normal X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2800.1807 X-Brightmail-Tracker: AAAAAQAAAAI= X-Brightmail-Tracker: AAAAAQAAAAI= X-Whitelist: TRUE X-Whitelist: TRUE 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:55587 Archived-At: > should something be said about this in the doc - for example, > say something about what with-output-* does, and mention that it > might be faster than creating and setting a buffer? i am against adding performace-related documentation. usually such info is implementation-specific (prone to eventual bit-rot). emacswiki is a better place for this kind of stuff, IMHO -- the expectation that info there can/will-be changed is much higher. I actually agree, and you stated the reasons well. In this case, it's not clear to me whether this is just a matter of implementation or whether there might be some difference in functionality that I'm not aware of. If the latter, then it would be good to add some more info about what with-output-to-temp-buffer does, to make this difference clear. If the former, then, yes, implementation concerns should not be documented. I'd still be curious about what is going on, however.