This seems intentional, not a case of docs lagging behind. If you look at the source of let you can see that it has :special-form true in its metadata so that it will remain documented as special even though it's just a macro.
I assume the thinking is that it's more useful to continue to document let, loop, and maybe others as special forms than to tell you they're macros that expand into uglier calls to special forms, and then go on to document (and support the APIs of) clojure.core/destructure and the less sugary, true special forms (let*, loop*, and maybe others). It's probably safe to assume these are implementation details that won't necessarily hold in other dialects of Clojure and that breaking changes in that layer might be introduced in a future version of Clojure and would not be considered a backwards-incompatible change by the maintainers. On Fri, Oct 4, 2013 at 2:47 PM, Amrut <amrut.jo...@gmail.com> wrote: > Thanks. I went through the checkins and looks like it was changed > here.<https://github.com/clojure/clojure/commit/3129be6d80d315e3be2f77dadcf7e904fc6015f5> > This > was 6 years back. Maybe it's time to update the documentation for special > forms. > > > On Friday, October 4, 2013 11:41:22 AM UTC-7, Gary Trakhman wrote: > >> The definitive authority on what is a special form and what isn't is >> Compiler.java: >> >> https://github.com/clojure/**clojure/blob/master/src/jvm/** >> clojure/lang/Compiler.java#L39<https://github.com/clojure/clojure/blob/master/src/jvm/clojure/lang/Compiler.java#L39> >> >> >> On Fri, Oct 4, 2013 at 2:27 PM, Amrut <amrut...@gmail.com> wrote: >> >>> Hello, >>> >>> According to this <http://clojure.org/special_forms>, "let" is a >>> special form. but the >>> source<http://clojuredocs.org/clojure_core/clojure.core/let> tells >>> me that it's a macro that uses let*. I could not find any info on let* form. >>> Can someone please explain what is happening here? >>> >>> TIA >>> >>> -- >>> -- >>> You received this message because you are subscribed to the Google >>> Groups "Clojure" group. >>> To post to this group, send email to clo...@googlegroups.com >>> >>> Note that posts from new members are moderated - please be patient with >>> your first post. >>> To unsubscribe from this group, send email to >>> clojure+u...@**googlegroups.com >>> >>> For more options, visit this group at >>> http://groups.google.com/**group/clojure?hl=en<http://groups.google.com/group/clojure?hl=en> >>> --- >>> You received this message because you are subscribed to the Google >>> Groups "Clojure" group. >>> To unsubscribe from this group and stop receiving emails from it, send >>> an email to clojure+u...@**googlegroups.com. >>> >>> For more options, visit >>> https://groups.google.com/**groups/opt_out<https://groups.google.com/groups/opt_out> >>> . >>> >> >> -- > -- > You received this message because you are subscribed to the Google > Groups "Clojure" group. > To post to this group, send email to clojure@googlegroups.com > Note that posts from new members are moderated - please be patient with > your first post. > To unsubscribe from this group, send email to > clojure+unsubscr...@googlegroups.com > For more options, visit this group at > http://groups.google.com/group/clojure?hl=en > --- > You received this message because you are subscribed to the Google Groups > "Clojure" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to clojure+unsubscr...@googlegroups.com. > For more options, visit https://groups.google.com/groups/opt_out. > -- http://elhumidor.blogspot.com/ -- -- You received this message because you are subscribed to the Google Groups "Clojure" group. To post to this group, send email to clojure@googlegroups.com Note that posts from new members are moderated - please be patient with your first post. To unsubscribe from this group, send email to clojure+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/clojure?hl=en --- You received this message because you are subscribed to the Google Groups "Clojure" group. To unsubscribe from this group and stop receiving emails from it, send an email to clojure+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/groups/opt_out.
