Chumsky项目中的ValueInput特性文档修正解析

在Rust语言的解析器组合库Chumsky中，ValueInput和BorrowInput是两个重要的输入特性(trait)。最近发现这两个特性的文档字符串出现了混淆，这可能会给开发者带来理解上的困扰。

ValueInput特性原本的文档描述为"可由其借用标记的输入实现"，这与BorrowInput特性的文档完全一致。这显然是一个文档错误，因为这两个特性实际上承担着不同的职责。

经过项目维护者的确认，ValueInput特性正确的文档描述应该是"可由其按值产生标记的输入实现"。这个修正准确地反映了ValueInput特性的核心功能——允许输入按值(value)而非引用(reference)产生标记(token)。

在解析器设计中，输入特性的这种区分非常重要：

• ValueInput表示输入可以完全交出标记的所有权
• BorrowInput则表示输入只能提供标记的借用(引用)

这种区分影响了解析器的内存管理方式和性能特征。按值传递通常意味着标记可以被解析器完全拥有和修改，而借用则意味着标记的生命周期受限于输入源。

这个文档修正虽然看似微小，但对于库的使用者正确理解和使用这些特性至关重要。特别是在构建高性能解析器时，理解输入是提供值还是引用可以帮助开发者做出更合适的设计决策。

Chumsky作为一个现代的解析器组合库，其设计注重类型安全和性能。这次文档修正体现了开源项目在持续改进中对细节的关注，也提醒我们在使用这类库时应该仔细阅读和理解每个特性的确切含义。