来自邮件列表
http://groups.google.com/group/clojure/msg/c41d909bd58e4534。在不自知的情况下使用已废弃的命名空间或变量非常容易。文档警告很小,没有编译器警告。
**建议:**
**添加新的动态变量 {{\*warn-on-deprecated*}},默认为 false
当加载具有 {{:deprecated true}}} 的命名空间时,向标准错误输出警告。
当分析具有 {{:deprecated true}}} 的变量时,向标准错误输出警告。
当展开具有 {{:deprecated true}}} 的宏时,向标准错误输出警告。
新的系统属性 clojure.compiler.warn-on-deprecated
使用 clojure.compiler.warn-on-deprecated 编译 Clojure 自身
修复 Clojure 内部的废弃警告(例如:replicate、clear-agent-errors)
使用 :deprecation 标签标记 clojure.parallel 为废弃
示例
(set! *warn-on-deprecated* true)
;; 使用一个废弃的变量(在编译时)
(defn ^:deprecated f [x] x)
(f 5)
;;=> 废弃警告,NO_SOURCE_PATH:7:1 : 变量 #'user/f 已废弃
;; 使用一个废弃的宏(在宏展开时)
(defmacro ^:deprecated m [x] x)
(m 5)
;;=> 废弃警告,NO_SOURCE_PATH:7:1 : 宏 #'user/m 已废弃
;; 使用一个废弃的命名空间(在加载时)
(ns foo {:deprecated "1.1"})
(ns bar (:require foo))
;;=> 废弃警告:从命名空间 `bar` 加载已废弃的命名空间 `foo`
**补丁:** 706-deprecated-ns-var-warnings-tested-3.diff
**问题:** 废弃警告的默认值应为 true 吗?升级用户可能会看到新的警告,可能会感到意外。
**是否应该默认警告或不禁用废弃?**