https://www.gnu.org/software/groff/manual/groff.html说 – 是减号。（在该页面上查找 [-]）
我认为它用于指定字符是减号而不是连字符。

你的描述并没有说清楚哪些是对的，哪些是错的。

看来我们当时使用减号作为连字符。

错误： http:
//linuxcnc.org/docs/devel/html/man/man1/halui.1.html

右： http:
//linuxcnc.org/docs/devel/html/gui/halui.html#_max_velocity

嗯，它在键盘上的 + 旁边。并在文本编辑器或编码时给你一个减号。

复杂的是文字处理器使用键插入连字符，这是一个不同的字符。

HAL 引脚名称肯定有减号作为破折号。

@andy
c-morley 上面发布的两个页面是否在您的机器上给您相同（正确）的连字符？

按照链接，复制并粘贴到http://www.hexed.it显示第一个为 unicode 连字符 (E2 88 92)
第二个是（正确的）2D。
但是，奇怪的是，如果我在自己的机器上查看在本地构建文档时生成的 HTML，连字符在那里也都是正确的。
<b>halui.tool.length-offset.b</b>(二维)

（查看从http://www.linuxcnc.org提供的原始 html ）
<b>halui.tool.length−offset.b</b>（E2 88 92）

因此，相同的工具似乎在不同的机器上从相同的输入文件生成不同的输出。

但是，奇怪的是，如果我在自己的机器上查看在本地构建文档时生成的 HTML，连字符在那里也都是正确的。

是的，在我的机器上它也能正确生成。

从 2.6 到 2.7 的构建过程是否有一些变化？
因为 2.6 的文档在这方面似乎是正确的。

( http://linuxcnc.org/docs/2.6/html/man/man1/halui.1.html <–> http://linuxcnc.org/docs/2.7/html/man/man1/halui.1。 HTML )

环顾四周，似乎转义连字符“-”（实际上是正确的）的联机帮助页以包含“-”的 html 结尾，然后呈现为破折号。
有趣的是，shuttle 联机帮助页并没有逃脱连字符，而且那个连字符是正确的。
因此，联机帮助页的诀窍可能是取消转义（监禁？）各处的减号。

是的，我在第一篇文章中提到过。
问题是它被回砍是否有充分的理由 – 似乎可能没有。

我想我应该在第一篇文章中说反斜杠减号

我尝试删除 Master 中 halui 联机帮助页中的转义符，并且正确生成了文档：
http
://linuxcnc.org/docs/devel/html/man/man1/halui.1.html 与未更改的 2.8 文档相比：
http ://linuxcnc.org/docs/2.8/html/man/man1/halui.1.html

所以，这似乎是对用 troff 编写的联机帮助页的修复，但不一定适用于用 asciidoc 编写的联机帮助页

尽管让 a2x（或它做的任何事情）不将 /- 转换为 &minus 会更整洁

奇怪的是，这个问题似乎是在试图解决这个问题时引入的：4a89720

我错过了关于这个问题的提交吗？或者有人修改了构建过程？因为现在它显示正确了。现在甚至显示图像?

我将文档的构建从 Wheezy 移到了 Buster。Buster 中较新版本的 docs 工具链可以正确解决这个问题。

为了后代，联机帮助页应使用：

• \-他们想要正常的“减号”字符（unicode 2d，我们过去称之为 ASCII 0x2d）。这包括 HAL 引脚名称和命令行参数，例如--verbose.
• -他们想要连字符的地方，例如在短语“命令行”中。

https://sourceforge.net/p/emc/mailman/emc-users/thread/a11d3b7a-1736-bb6c-77cc-3112246f8d86%40gmail.com/#msg37235008

干得好！