Komentarze skryptu powłoki wielowierszowej - jak to działa?

Ostatnio natknąłem się na wieloliniowy typ komentarza, którego nigdy wcześniej nie widziałem - oto przykład skryptu:

echo a
#
: aaa 
: ddd 
#
echo b

To wydaje się działać, nawet vimpodkreśla składnię. Jak nazywa się ten styl komentowania i jak znaleźć więcej informacji na jego temat?

To nie jest komentarz wieloliniowy. #to komentarz jednowierszowy. :(dwukropek) wcale nie jest komentarzem, ale raczej wbudowaną komendą powłoki, która jest w zasadzie NOP , operacją zerową, która nie robi nic oprócz powrotu true, jak true(a zatem ustawienie $?na 0 jako efekt uboczny). Ponieważ jednak jest to polecenie, może akceptować argumenty, a ponieważ ignoruje swoje argumenty, w większości przypadków powierzchownie działa jak komentarz. Głównym problemem związanym z tą kludge jest to, że argumenty są wciąż rozszerzane, co prowadzi do wielu niezamierzonych konsekwencji. Na argumenty nadal mają wpływ błędy składniowe, przekierowania są nadal wykonywane, więc : > filezostaną obcięte file, a : $(dangerous command)podstawienia nadal będą działać.

Najmniej zaskakujący całkowicie bezpieczny sposób wstawiania komentarzy w skryptach powłoki to #. Trzymaj się tego nawet w przypadku komentarzy wieloliniowych. Nigdy nie próbuj (ab) używać :do komentowania. Nie ma dedykowanego wieloliniowego mechanizmu komentowania w powłoce, który byłby analogiczny do postaci ukośnej gwiazdki /* */w Cpodobnych językach.

Ze względu na kompletność, ale nie dlatego, że jest to zalecana praktyka, wspomnę, że można użyć dokumentów tutaj do robienia wieloliniowych „komentarzy”:

: <<'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

To nie jest żaden styl komentowania. :wbudowaną komenda robi nic; jest nadużywane za komentowanie tutaj.

$ help :
:: :
    Null command.

    No effect; the command does nothing.

    Exit Status:
    Always succeeds.

We wczesnych powłokach dwukropek był jedynym sposobem na tworzenie komentarzy.

Nie jest to jednak prawdziwy komentarz, ponieważ linia jest analizowana dokładnie w taki sam sposób, jak każde inne polecenie, co może mieć skutki uboczne. Na przykład:

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

: $(command) # executes 'command'

(Czasami okrężnica jest używana wyłącznie w celu wywołania tych skutków ubocznych, ale wtedy nie jest używana jako komentarz).

Czasami wygodnie jest użyć dwukropka, aby skomentować część skryptu:

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

Jest to wielka oszczędność czasu w porównaniu z poprzednimi wierszami #, szczególnie jeśli komentowanie jest tylko tymczasowe.

Jeśli Twój komentarz znajduje się na końcu skryptu, możesz to zrobić w następujący sposób:

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