请求更改(doc take-while)文档字符串

Question

请求更改(doc take-while)

当前说明为：

---

clojure.core/take-while
([pred] [pred coll])
当(pred item)返回逻辑真时，返回coll中连续项的懒序列。
pred必须不应有任何副作用。
当没有提供集合时，返回一个转换器。

更改为：

---

clojure.core/take-while
([pred] [pred coll])
当(pred item)返回逻辑真时，返回coll中连续项的懒序列。
当(pred item)返回逻辑真并首次遇到false时停止。pred必须不应有任何副作用。
当没有提供集合时，返回一个转换器。

这会让程序新手感到困惑。

查看：

https://stackoverflow.com/questions/69845947/why-is-take-while-returning-empty-sequence

Answer 1

你好，感谢你的建议，但我们认为不会改变这个。

"while (pred item) 返回逻辑真"就足够了——“while”意味着“当条件成立时”。

Clojure 核心文档字符串故意使用语言非常经济。当然，它们并不完美，Clojure 几乎每个版本都更新了文档字符串，所以我们在合适的地方愿意改变它们，但我认为这里不是合适的地方。

许多初学者需要更多的信息，我们有许多辅助资源，如https://docs.clojure.org/clojure.core/take-while，Clojure 用户可以在此提供示例、额外评论、链接等，以补充核心文档字符串。Clojure 官方文档也提供了链接到 ClojureDocs。

Comments

StackOverflow的发布者遗漏了单词"successive"（或者完全错过了API文档）。

---

感谢您抽出时间回复。