Bash block and multiline comment styles

bash_multiline_comment.sh

#!/usr/bin/env bash

: <<'### README ###'

Style 1
=======
This is a multiline comment, created by combining two relatively
less known Bash features, the `:` command, and Here Documents.

This has the advantage of less syntactic noise per line, and the
ability for syntax highlighting in case you have embedded code
block in comments (this can be a double-edged sword, though, 
because highlighting regular English words that are also Bash
keywords such as for, in, fi, etc.

Moreover, this uses a relatively obscure features of Bash, and
violates the Principle of Least Astonishment. 

Example usage:

$ bash bash_multiline_comment.sh
### README ###

################################################################
# 
# Style 2
# =======
# Or you can go with the traditional style, which is, of course
# not the block comment style as above, but rather a multiline 
# comment, by commenting out each line. 
# 
# This style uses only one feature of Bash, and is less obscure.
# A minor disadvantage is losing syntax highlighting for code
# blocks embedded inside this style of comment:
#
# Example usage:
#
# $ bash bash_multiline_comment.sh
################################################################