Commenti di script shell multilinea: come funziona?

Di recente, mi sono imbattuto in un tipo di commento multilinea che non avevo mai visto prima - ecco un esempio di script:

echo a
#
: aaa 
: ddd 
#
echo b

Questo sembra funzionare, anche la vimsintassi lo evidenzia. Come si chiama questo stile di commento e come posso trovare maggiori informazioni a riguardo?

Questo non è un commento su più righe. #è un commento a riga singola. :(due punti) non è affatto un commento, ma piuttosto un comando incorporato della shell che è fondamentalmente un NOP , un'operazione nulla che non fa altro che restituire true, come true(e quindi impostare $?su 0 come effetto collaterale). Tuttavia, poiché è un comando, può accettare argomenti e poiché ignora i suoi argomenti, nella maggior parte dei casi agisce superficialmente come un commento. Il problema principale con questo kludge è che gli argomenti sono ancora espansi, portando a una serie di conseguenze indesiderate. Gli argomenti sono ancora influenzati da errori di sintassi, i reindirizzamenti vengono comunque eseguiti, quindi : > fileverranno troncati filee le : $(dangerous command)sostituzioni verranno comunque eseguite.

Il modo meno sorprendente e completamente sicuro per inserire commenti negli script di shell è con #. Attenersi a questo anche per i commenti su più righe. Non tentare mai di (ab) utilizzare :per i commenti. Non esiste un meccanismo di commento multi-linea dedicato nella shell analogo alla /* */forma a stella in Clinguaggi simili.

Per completezza, ma non perché è una pratica raccomandata, citerò che è possibile usare i documenti qui per fare "commenti" su più righe:

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

Non è uno stile di commento. il :comando integrato non fa assolutamente nulla; viene abusato per i commenti qui.

$ help :
:: :
    Null command.

    No effect; the command does nothing.

    Exit Status:
    Always succeeds.

Nelle prime conchiglie, i due punti erano l'unico modo per creare commenti.

Tuttavia, non è un vero commento, perché la riga viene analizzata esattamente come qualsiasi altro comando viene analizzato e ciò può avere effetti collaterali. Per esempio:

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

: $(command) # executes 'command'

(A volte i due punti vengono utilizzati esclusivamente allo scopo di invocare quegli effetti collaterali, ma non vengono utilizzati come commenti.)

A volte è conveniente usare i due punti per commentare una sezione di uno script:

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

Questo è un grande risparmio di tempo rispetto al precedente di ogni riga #, in particolare se il commento è solo temporaneo.

Se il tuo commento è alla fine dello script, puoi farlo in questo modo:

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