Komentar skrip shell multiline - bagaimana cara kerjanya?

Baru-baru ini, saya menemukan jenis komentar multiline yang belum pernah saya lihat sebelumnya - ini adalah contoh skrip:

echo a
#
: aaa 
: ddd 
#
echo b

Ini tampaknya berhasil, bahkan vimsintaks-menyoroti itu. Apa sebutan gaya komentar ini dan bagaimana cara menemukan lebih banyak info tentangnya?

Itu bukan komentar multi-baris. #adalah komentar satu baris. :(titik dua) bukan komentar sama sekali, melainkan perintah built-in shell yang pada dasarnya adalah NOP , operasi null yang tidak melakukan apa-apa kecuali mengembalikan true, seperti true(dan dengan demikian menetapkan $?ke 0 sebagai efek samping). Namun karena itu adalah perintah, ia dapat menerima argumen, dan karena mengabaikan argumennya, dalam kebanyakan kasus ia bertindak secara dangkal seperti komentar. Masalah utama dengan lumpur ini adalah argumen masih diperluas, yang mengarah ke sejumlah konsekuensi yang tidak diinginkan. Argumen masih dipengaruhi oleh kesalahan sintaksis, pengalihan masih dilakukan sehingga : > fileakan terpotong file, dan : $(dangerous command)substitusi akan tetap berjalan.

Cara yang paling tidak mengejutkan yang sepenuhnya aman untuk memasukkan komentar dalam skrip shell adalah dengan #. Tetap berpegang pada itu bahkan untuk komentar multi-line. Jangan pernah mencoba (ab) menggunakan :komentar. Tidak ada mekanisme komentar multisaluran khusus di shell yang analog dengan /* */bentuk bintang-slash dalam Cbahasa yang mirip.

Demi kelengkapan, tetapi bukan karena itu adalah praktik yang disarankan, saya akan menyebutkan bahwa dimungkinkan untuk menggunakan dokumen-dokumen di sini untuk melakukan "komentar" multi-baris:

: <<'end_long_comment'
This is an abuse of the null command ':' and the here-document syntax
to achieve a "multi-line comment".  According to the POSIX spec linked 
above, if any character in the delimiter word ("end_long_comment" in 
this case) above is quoted, the here-document will not be expanded in 
any way.  This is **critical**, as failing to quote the "end_long_comment" 
will result in the problems with unintended expansions described above. 
All of this text in this here-doc goes to the standard input of :, which 
does nothing with it, hence the effect is like a comment.  There is very 
little point to doing this besides throwing people off.  Just use '#'.
end_long_comment

Itu bukan gaya berkomentar. yang :built-in command tidak apa-apa; itu disalahgunakan karena berkomentar di sini.

$ help :
:: :
    Null command.

    No effect; the command does nothing.

    Exit Status:
    Always succeeds.

Pada awalnya, titik dua adalah satu-satunya cara untuk membuat komentar.

Namun, itu bukan komentar yang benar, karena baris diuraikan dengan cara yang persis sama seperti perintah lain diuraikan, dan itu mungkin memiliki efek samping. Sebagai contoh:

: ${a:=x} # assigns the value 'x' to the variable, 'a'

: $(command) # executes 'command'

(Terkadang usus besar digunakan hanya untuk tujuan memunculkan efek samping itu, tetapi kemudian tidak digunakan sebagai komentar.)

Terkadang nyaman menggunakan tanda titik dua untuk mengomentari bagian skrip:

: '
while [ "$n" -ne "$x" ]
do
  : whatever
done
'

Ini adalah penghemat waktu yang hebat dibandingkan dengan mendahului setiap baris #, terutama jika komentar hanya bersifat sementara.

Jika komentar Anda di akhir skrip, Anda dapat melakukannya seperti ini:

#!/bin/sh
echo 'hello world'
exec true
we can put whatever we want here
\'\"\$\`!#%&()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_
abcdefghijklmnopqrstuvwxyz{|}~