In den letzten Tage habe ich ziemlich viel Shell Skripte geschrieben. Immer wieder wollte ich ganze Teile des Skripts auskommentieren, um diese zu überspringen. Leider sind mehrzeilige Kommentare im Stile von HTML mit <!-- und --> oder wie bei PHP mit /* und */ bei Shell Skripten nicht  vorgesehen. Doch es gibt zwei kleine Workarounds:

echo "Hiernach sind Kommentare."
: '
Ein mehrzeiliger Kommentar,
der alles notwendige erlaeutert,
was man wissen sollte
'
echo "Obendrueber steht ein Kommentar."

Das ist der einfache Weg. Er funktioniert allerdings nur, wenn ihr keine einfachen Anführungszeichen im Kommentar habt. Das ist bei mir meistens der Fall. Wenn ihr diese einfachen Anführungszeichen aber in eurem Kommentar benötigt, dann nutzt Variante B:

echo "Auch hiernach ein Kommentar."
: <<KOMMENTARIO
Ein toller und eloquenter Kommentar,
der jeden Zweifel ueber schlechten Code
ausrauemt.
KOMMENTARIO
echo "Obendrueber war ein Kommentar."

Jetzt arbeiten wir also geschickt mit Here documents. Das hat auch den Vorteil, dass man im vi oder dem entsprechenden Editor nach der EOF Terminierung suchen kann.

Quelle: Das empfehlenswerte unix.com-Forum