* bug#12760: letf doc is not very helpful
@ 2012-10-29 7:52 Glenn Morris
2012-10-29 13:52 ` Stefan Monnier
0 siblings, 1 reply; 5+ messages in thread
From: Glenn Morris @ 2012-10-29 7:52 UTC (permalink / raw)
To: 12760
Package: emacs
Version: 24.2.50
Severity: minor
emacs -Q -l cl
C-h f letf
-> Like `cl-letf', but with some extra backward compatibility.
This is so vague as to not be useful.
^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#12760: letf doc is not very helpful
2012-10-29 7:52 bug#12760: letf doc is not very helpful Glenn Morris
@ 2012-10-29 13:52 ` Stefan Monnier
2012-10-29 17:40 ` Glenn Morris
2012-10-30 7:05 ` Glenn Morris
0 siblings, 2 replies; 5+ messages in thread
From: Stefan Monnier @ 2012-10-29 13:52 UTC (permalink / raw)
To: Glenn Morris; +Cc: 12760
> -> 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.
Stefan
^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#12760: letf doc is not very helpful
2012-10-29 13:52 ` Stefan Monnier
@ 2012-10-29 17:40 ` Glenn Morris
2012-10-30 7:05 ` Glenn Morris
1 sibling, 0 replies; 5+ messages in thread
From: Glenn Morris @ 2012-10-29 17:40 UTC (permalink / raw)
To: Stefan Monnier; +Cc: 12760
Stefan Monnier wrote:
>> -> 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.
Maybe you want to mark letf obsolete (as labels and flet are).
^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#12760: letf doc is not very helpful
2012-10-29 13:52 ` Stefan Monnier
2012-10-29 17:40 ` Glenn Morris
@ 2012-10-30 7:05 ` Glenn Morris
2012-10-30 12:31 ` Stefan Monnier
1 sibling, 1 reply; 5+ messages in thread
From: Glenn Morris @ 2012-10-30 7:05 UTC (permalink / raw)
To: Stefan Monnier; +Cc: 12760
Stefan Monnier wrote:
>> -> 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."
^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#12760: letf doc is not very helpful
2012-10-30 7:05 ` Glenn Morris
@ 2012-10-30 12:31 ` Stefan Monnier
0 siblings, 0 replies; 5+ messages in thread
From: Stefan Monnier @ 2012-10-30 12:31 UTC (permalink / raw)
To: Glenn Morris; +Cc: 12760
>>> -> 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
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2012-10-30 12:31 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2012-10-29 7:52 bug#12760: letf doc is not very helpful Glenn Morris
2012-10-29 13:52 ` Stefan Monnier
2012-10-29 17:40 ` Glenn Morris
2012-10-30 7:05 ` Glenn Morris
2012-10-30 12:31 ` Stefan Monnier
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).