From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.bugs Subject: bug#12760: letf doc is not very helpful Date: Tue, 30 Oct 2012 08:31:40 -0400 Message-ID: References: <4gtxtcxwvm.fsf@fencepost.gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1351600369 17500 80.91.229.3 (30 Oct 2012 12:32:49 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 30 Oct 2012 12:32:49 +0000 (UTC) Cc: 12760@debbugs.gnu.org To: Glenn Morris Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Oct 30 13:32:58 2012 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1TTB05-0002GU-S9 for geb-bug-gnu-emacs@m.gmane.org; Tue, 30 Oct 2012 13:32:57 +0100 Original-Received: from localhost ([::1]:60975 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TTAzv-0005mH-Mp for geb-bug-gnu-emacs@m.gmane.org; Tue, 30 Oct 2012 08:32:47 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:55505) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TTAzo-0005lA-6g for bug-gnu-emacs@gnu.org; Tue, 30 Oct 2012 08:32:46 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TTAzf-0000Mr-BN for bug-gnu-emacs@gnu.org; Tue, 30 Oct 2012 08:32:40 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:57164) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TTAzf-0000Mn-7v for bug-gnu-emacs@gnu.org; Tue, 30 Oct 2012 08:32:31 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1TTB26-0007Cx-2Y for bug-gnu-emacs@gnu.org; Tue, 30 Oct 2012 08:35:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Stefan Monnier Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 30 Oct 2012 12:35:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 12760 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 12760-submit@debbugs.gnu.org id=B12760.135160045527655 (code B ref 12760); Tue, 30 Oct 2012 12:35:02 +0000 Original-Received: (at 12760) by debbugs.gnu.org; 30 Oct 2012 12:34:15 +0000 Original-Received: from localhost ([127.0.0.1]:39182 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TTB1L-0007C0-4B for submit@debbugs.gnu.org; Tue, 30 Oct 2012 08:34:15 -0400 Original-Received: from ironport2-out.teksavvy.com ([206.248.154.182]:43311) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TTB1J-0007Bt-IO for 12760@debbugs.gnu.org; Tue, 30 Oct 2012 08:34:13 -0400 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: Av0EAG6Zu0/O+LET/2dsb2JhbABEtBGBCIIWAQUnLyMQCw4mEhQYDSQuh3O6CZBEA6MzgViDBQ X-IronPort-AV: E=Sophos;i="4.75,637,1330923600"; d="scan'208";a="203136705" Original-Received: from 206-248-177-19.dsl.teksavvy.com (HELO pastel.home) ([206.248.177.19]) by ironport2-out.teksavvy.com with ESMTP/TLS/ADH-AES256-SHA; 30 Oct 2012 08:31:41 -0400 Original-Received: by pastel.home (Postfix, from userid 20848) id 9663059419; Tue, 30 Oct 2012 08:31:40 -0400 (EDT) In-Reply-To: <4gtxtcxwvm.fsf@fencepost.gnu.org> (Glenn Morris's message of "Tue, 30 Oct 2012 03:05:49 -0400") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.2.50 (gnu/linux) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:66234 Archived-At: >>> -> Like `cl-letf', but with some extra backward compatibility. >>> This is so vague as to not be useful. >> The only difference (handling of funbound symbols for symbol-function) >> is one I'd rather not document because it's deprecated. > PS I honestly can't see why "A is different to B in some unspecified way > that I'm not going to tell you lest you try and use it" is preferable to > "A is essentially exactly the same as B, apart from cases C and D. Such > usage is deprecated." You might be right. Here is the exact situation: - The extra handling of `symbol-function' in `letf' was added because some existing uses of `flet' (which uses `letf' internally) need it. - I don't know of any code that uses `letf' in a way that `cl-letf' can't handle. So maybe a better solution is to rename the current `letf' into cl--flet-letf, and then to make `letf' an alias to `cl-letf'. Stefan