emacs - 为什么 REPL 将 clojure.core/doc 视为 var？

Question

我正在尝试使用 Clojure doc 获取文档功能，但无法从 REPL 中识别它(我正在使用 Emacs 和 SLIME)。以下序列描述了正在发生的事情(错误消息紧跟在每一行之后):

gaidica.core> (doc first)
; Evaluation aborted.

Unable to resolve symbol: doc in this context
  [Thrown class java.lang.Exception]

gaidica.core> (clojure.core/doc first)
; Evaluation aborted.

No such var: clojure.core/doc
  [Thrown class java.lang.Exception]

user> (clojure.core/doc first)
; Evaluation aborted.

No such var: clojure.core/doc
  [Thrown class java.lang.Exception]

user> (doc first)
-------------------------
clojure.core/first
([coll])
  Returns the first item in the collection. Calls seq on its
    argument. If coll is nil, returns nil.
nil
user> 

如何引用 doc函数并将其识别为函数，而不是变量？

附录，2011 年 6 月 22 日，问题发布后 9 小时

@kotarak 发表了最相关的评论:“注意，clojure.core/doc 是 1.2 及更早版本。clojure.repl/doc 是 1.3 及更高版本。”果然，以下工作:

user> (clojure.repl/doc first)
-------------------------
clojure.core/first
([coll])
  Returns the first item in the collection. Calls seq on its
    argument. If coll is nil, returns nil.
nil
user>

我能够确认 Clojure 1.3 处于事件状态:

user> *clojure-version*
{:interim true, :major 1, :minor 3, :incremental 0, :qualifier "master"}
user> 

但这也令人困惑——我的 Leiningen project.clj 指定了 Clojure 1.2!

根据我自己的经验，我曾经注意到，即使在我更改了相关目录的内容之后，基于 SLIME 的 REPL 也会“卡在”Java 类路径值上。解决方案是退出 Emacs 和 lein swank。 ，然后重新输入两者并重试。我尝试了同样的方法并得到了以下结果:

user> *clojure-version*
{:major 1, :minor 2, :incremental 0, :qualifier ""}
user> 

我能得出的唯一结论是我之前的 REPL 一直在使用 Clojure 1.3。我之前从事的项目使用了 Clojure 1.3 快照，所以我猜测 REPL 以某种方式“卡在”Clojure 1.3 上。

问题已解决，经验教训等。对于加分，任何人都可以解释发生的原因(使用 Clojure 1.2 与 1.3)吗？

感谢所有做出贡献的人。

Answer 1

几个更正。首先， doc 是宏而不是函数。函数和宏也可以存储在 var 中。其次，在 clojure 1.3(可能是您正在使用的版本)中，doc 存储在 var clojure.repl/doc 中，而不是 clojure.core/doc 中(就像在 1.2 中一样)。在命名空间用户中，doc 是“使用的”，也就是隐含的“(使用 [clojure.repl :only [doc])”。当你进入一个新的命名空间，甚至使用 ns 创建一个命名空间时，不会自动添加 clojure.repl/doc，不像使用 'user.

为了更明确地了解这些问题:

为什么 REPL 将 clojure.core/doc 视为 var？

clojure 中的函数、宏和值要么存储在 vars 中，要么绑定(bind)到诸如 let 或函数中的符号。 clojure.core/doc 是包含执行 doc 功能的宏的 var。

如何引用 doc 函数并将其识别为函数，而不是变量？

就像在所有 lisps 中一样，要进行调用，无论是函数还是宏，都必须将函数/宏放在列表的第一个位置。

(<fn/macro> *args)

所以要自己调用宏文档，你会这样做:

(doc doc)