How to decorate comments in bash?

Question

From time to time I see similar framing for comments in bash scripts:

#!/bin/bash
#===================================================================================
#
# FILE: stale-links.sh
#
# USAGE: stale-links.sh [-d] [-l] [-oD logfile] [-h] [starting directories]
#
# DESCRIPTION: List and/or delete all stale links in directory trees.
# The default starting directory is the current directory.
# Don’t descend directories on other filesystems.
#===================================================================================

Is there any program to generate such a decoration for comments or do people usually create it manually?

P.S. After some search, I found similar threads:
How can I create a message box from the command line?
bash script , echo output in box

Answer 1

I really like Thomas Jensen's boxes. It does a lot more than just the comment boxes you describe, and more than just for shell scripts. It's a command-line utility and it also integrates with several text editors, including my personal favorite.

Answer 2

If all you want is the informative header at the top of your scripts, you could do it without a plugin or external utility. Create a bash_script_template.sh that looks something like this:

#!/bin/bash

############################################################
# Filename   : x                                           #
# Author     : x                                           #
# Created    : x                                           #
# Last edit  : x                                           #
# Purpose    : x                                           #
# Reference  : x                                           #
# Depends    : x                                           #
# Arguments  : x                                           #
# Known bugs : x                                           #
# To do      : x                                           #
############################################################

# GNU All-Permissive License {{{
#############################################################
# Copyright © 2022 my_name                                  #
#                                                           #
# Copying and distribution of this file, with or without    #
# modification, are permitted in any medium without         #
# royalty, provided the copyright notice and this notice    #
# are preserved.                                            #
#                                                           #
# This file is offered as-is, without any warranty.         #
#############################################################
# End license }}}

When you want to write a new script, copy the template to a new filename or read it into the top of an empty buffer.