What do you think about his model of docstring?

# Explain the function utilty here
# PARAMETERS: ....
# RETURN: ....

An example:
# Displays a message on the standard output
# PARAMETERS: 
#     $1 = message to display
# RETURN:
#     0 = Success
#     The error code otherwise