多行bash评论礼仪(#+)

sim*_*ont 7 bash

高级Bash脚本编程指南广泛使用的例子多行注释的形式,:

echo ls -l | sh
#  Passes the output of "echo ls -l" to the shell,
#+ with the same result as a simple "ls -l".
Run Code Online (Sandbox Code Playgroud)

(在管道|符号的说明中找到).其他多行注释如下所示:

#!/bin/bash
# rpm-check.sh

#  Queries an rpm file for description, listing,
#+ and whether it can be installed.
#  Saves output to a file.
# 
#  This script illustrates using a code block.
Run Code Online (Sandbox Code Playgroud)

(链接页面中的示例3.2).

什么是ratonale使用#+?一些多线评论似乎表明评论在下一行继续,但其他评论则没有.
我是否应该(尝试)遵循我自己的脚本中的"bash-scripting评论礼仪"?

Bri*_*ell 6

似乎Advanced Bash脚本编写指南的作者在继续上一行句子的行上使用它.

这不是标准的风格选择; 这似乎是Advanced Bash Scripting Guide的作者的风格怪癖.

我将注意到虽然Advanced Bash Scripting Guide中有一些很好的技术信息,但编码风格相当不标准.我不会将它用作良好的Bash编码实践的一个例子.一个更好的资源是Bash FAQ.