Comentarios de script de shell multilínea: ¿cómo funciona esto?

Recientemente, me topé con un tipo de comentario de varias líneas que nunca había visto antes; aquí hay un ejemplo de script:

echo a
#
: aaa 
: ddd 
#
echo b

Esto parece funcionar, incluso la vimsintaxis lo resalta. ¿Cómo se llama este estilo de comentarios y cómo puedo encontrar más información al respecto?

Ese no es un comentario de varias líneas. #es un comentario de una sola línea :(dos puntos) no es un comentario en absoluto, sino más bien un comando incorporado de shell que es básicamente un NOP , una operación nula que no hace nada excepto devolver true, like true(y, por lo tanto, establecer $?a 0 como efecto secundario). Sin embargo, dado que es un comando, puede aceptar argumentos, y dado que ignora sus argumentos, en la mayoría de los casos actúa superficialmente como un comentario. El principal problema con este error es que los argumentos aún se expanden, lo que lleva a una serie de consecuencias no deseadas. Los argumentos todavía se ven afectados por los errores de sintaxis, las redirecciones aún se realizan, por lo que : > filese truncarán filey las : $(dangerous command)sustituciones se seguirán ejecutando.

La forma menos segura y sorprendente de insertar comentarios en los scripts de shell es con #. Apéguese a eso incluso para comentarios de varias líneas. Nunca intente (ab) usarlo :para comentarios. No hay un mecanismo de comentarios de varias líneas dedicado en el shell que sea análogo a la forma de barra diagonal /* */en Clenguajes similares.

En aras de la exhaustividad, pero no porque sea una práctica recomendada, mencionaré que es posible utilizar documentos aquí para hacer "comentarios" de varias líneas:

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

No es ningún estilo de comentario. el :comando incorporado no hace absolutamente nada; se está abusando de comentar aquí.

$ help :
:: :
    Null command.

    No effect; the command does nothing.

    Exit Status:
    Always succeeds.

En los primeros depósitos, el colon era la única forma de crear comentarios.

Sin embargo, no es un comentario verdadero, porque la línea se analiza exactamente de la misma manera que cualquier otro comando, y eso puede tener efectos secundarios. Por ejemplo:

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

: $(command) # executes 'command'

(A veces, el colon se usa únicamente con el fin de invocar esos efectos secundarios, pero luego no se usa como comentario).

A veces es conveniente usar los dos puntos para comentar una sección de un script:

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

Esto es un gran ahorro de tiempo sobre el precedente de cada línea #, particularmente si el comentario es solo temporal.

Si su comentario está al final del guión, puede hacerlo así:

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