Comentar uma área do código para que não seja executada durante um teste, ou mesmo inserir uma descrição de várias linhas é algo útil em algumas ocasiões. Mas como fazer isto em scripts bash, sem necessitar inserir um caractere "#" em cada linha?

Procurando por algo para o bash semelhante ao /* */ usado no C e Java, encontrei as opções abaixo.

Opção 1

:<<'STRING-DELIMITADORA'
STRING-DELIMITADORA

Onde o conteúdo a ser comentado ficará ente ":<<'STRING-DELIMITADORA'" e "STRING-DELIMITADORA". Notem que o texto "STRING-DELIMITADORA", pode ser uma sequência de caracteres qualquer, desde que não exista outra exatamente igual nas linhas que pretende comentar.

Exemplo usando a string SCML (acrônimo para Shell, Comentário Muito Longo):

Opção 2

: '

'

Exemplo:


Observações:

1. Isto funciona apenas no shell bash, não funcionará para scripts feitos para o CSH ou ZSH.
2. As opções descritas acima, fazem na verdade uso do comando nulo (:), devendo ser usadas com cuidado. São mais úteis na fase de construção e teste, como para comentar rapidamente alguma parte do código ao fazer um teste. Porém, ao distribuir para uso em produção, é mais seguro comentar com o #, tarefa que pode ser agilizada com o auxílio do seu editor de texto favorito.

No Vim/Vi, por exemplo, pode-se inserir o "#" em um intervalo de linhas facilmente. No modo de comando (Esc + :):

linhainicial,linhafinals/^/#/g[ENTER]

Exemplo:

15,43s/^/#/g

Fonte:

• bash - Multiline shell script comments - how does this work? - Unix & Linux Stack Exchange