Comentários sobre scripts de shell multilinha - como isso funciona?

Recentemente, deparei-me com um tipo de comentário multilinha que nunca vi antes - aqui está um exemplo de script:

echo a
#
: aaa 
: ddd 
#
echo b

Isso parece funcionar, até a vimsintaxe destaca. Como é chamado esse estilo de comentário e como encontro mais informações sobre ele?

Esse não é um comentário de várias linhas. #é um comentário de linha única. :(dois pontos) não é um comentário, mas um comando interno do shell que é basicamente um NOP , uma operação nula que não faz nada, exceto retornar true, como true(por exemplo, definir $?0 como um efeito colateral). No entanto, como é um comando, ele pode aceitar argumentos e, como ignora seus argumentos, na maioria dos casos age superficialmente como um comentário. O principal problema desse kludge é que os argumentos ainda são expandidos, levando a uma série de consequências não intencionais. Os argumentos ainda são afetados por erros de sintaxe, os redirecionamentos ainda são executados e, portanto, : > fileserão truncados filee as : $(dangerous command)substituições ainda serão executadas.

A maneira menos surpreendente e completamente segura de inserir comentários em scripts de shell é com #. Atenha-se a isso mesmo para comentários de várias linhas. Nunca tente (ab) usar :para comentários. Não existe um mecanismo de comentário de várias linhas dedicado no shell que seja análogo à /* */forma de estrela de barra em Cidiomas semelhantes.

Por uma questão de completude, mas não porque é uma prática recomendada, mencionarei que é possível usar os documentos aqui para fazer "comentários" multilinhas:

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

Não é nenhum estilo de comentar. o :comando interno não faz absolutamente nada; está sendo abusado por comentar aqui.

$ help :
:: :
    Null command.

    No effect; the command does nothing.

    Exit Status:
    Always succeeds.

Nos primeiros anos, o cólon era a única maneira de criar comentários.

No entanto, não é um comentário verdadeiro, porque a linha é analisada exatamente da mesma maneira que qualquer outro comando, e que pode ter efeitos colaterais. Por exemplo:

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

: $(command) # executes 'command'

(Às vezes, o cólon é usado apenas com o objetivo de invocar esses efeitos colaterais, mas depois não está sendo usado como comentário.)

Às vezes, é conveniente usar dois pontos para comentar uma seção de um script:

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

Isso economiza bastante o tempo que precede cada linha #, principalmente se os comentários forem apenas temporários.

Se seu comentário estiver no final do script, você poderá fazer o seguinte:

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