Bash 行注释续

Question

我看到一些 bash/shell 注释使用了这个符号

#  Some comment block that starts on line 1, but then
#+ continues on line 2 with this silly plus sign.

#  And this is another comment line that is not related to the ones above

“#+”是否有助于任何类型的解析器(例如如何使用 Doxygen 风格的注释来自动生成文档)？

这是一种常见的做法吗？我知道，就实际的脚本执行而言，包含/排除它不会有任何损害，但我很好奇采用这种评论方式是否有优势。

Answer 1

根据Advanced Bash-Scripting Guide , 看起来这是几个 comment headers 之一可以用来提高脚本中的清晰度和易读性。这个花絮出现在指南的“各种提示”部分:

Use special-purpose comment headers to increase clarity and legibility in scripts.

以下是他们在指南的示例 block 中列出的几个:

## Caution.
rm -rf *.zzy   ##  The "-rf" options to "rm" are very dangerous,
               ##+ especially with wild cards.

#+ Line continuation.
#  This is line 1
#+ of a multi-line comment,
#+ and this is the final line.

#* Note.

#o List item.

#> Another point of view.
while [ "$var1" != "end" ]    #> while test "$var1" != "end"

显然有些人发现这些小细节很有帮助，但我个人认为这样做并没有太大好处。