Fun things to put in comments in scripts?

Approaching the end of my portion of some STIG/DOD compliance automation and I was challenged by a co-worker to include a story in my code. There are blocks of code that need to be kept the way they are for GIT/Gerrit and then compliance, but otherwise I changed out all the comments into a not-helpful 300 rendition. I realize the lack of useful comments will make the script a bit harder to manage, and I also realize not everyone will agree with parts of it (Like my hatred for having to take scripts written in bash and then take out the fancy parts so they're portable), but mostly just wanted to share as I was proud of my lack of accomplishment and thought some other folk may get a chuckle out of it.

I kind of drifted a lot and by the end was completely out in the left-field of nonsense. The 300 intro script is way longer than I remembered it being, and I just wanted to get done with this and move on to the next one by the end =]

If other folks have similar things they've nested into scripts, would like to see; if this is too off-topic and gets blasted by a mod as such, my bad m(_ _)m

# cat GEN004580.sh |grep '^[\ ]*#'
#/bin/sh
#######################################################################################################
#
# Package               : XCCDF Scripts
# bc_description        :
# bc_filename           : GEN004580.sh
# bc_client_loc         : /usr/local/scripts/xccdf/gen/
# bc_platform           : all
# bc_owner              : root|root
# bc_perms              : 0500
# bc_host               : all
#
# Company               : XXXXXXX
# Author                : XXXXXX
# Revision              : 1
#
#######################################################################################################
#######################################################################################################
#
# CHANGELOG
#
# Jul 24 2012   : First version
#
#######################################################################################################
#######################################################################################################
# XCCDF Definitions
#######################################################################################################
#######################################################################################################
# Header Definitions/Initializations
#######################################################################################################
## When the script was born.
    ## Like all scripts, it was inspected.
    ## if it has been malwritten
    ## or unmanageable, or inefficient, or written only in bash
## It would have been discarded
#######################################################################################################
# Begin testing.
#######################################################################################################
## From the first execution, it was baptised in the fire of bourne shell.
    ## Taught never to be incompatible.
    ## Never to run only on one version of Unix.
    ## Taught that proper error checking  -- striving in service to efficiency.
        ## Is the greatest glory any script can ever achieve.
        ## Upon completion of any script, as customary in shell scripting.
            ## The script is taken from it's testing ground and plunged into a world of debugging.
            ## Manufactured by 40 years.
            ## a Spartan programming society.
        ## To create the finest shell scripts the world has ever known.
    ## The agoge is its goal.
        ## It forces the scripter to fight -- Breaks him.
        ## It forces him to google
        ## and if necessary, to mIRC
## By sed, awk, and grep
## The scripter is punished.
    ## Taught to show no emotion, to indent without mercy.
    ## Hunting to be tested, tossed into the basest of shells.
## Left to pit his will and mind against understanding a regular expressions fury.
    ## It is his initiation, his time in the bourne shell.
    ## For he will return with compliant code, or not at all.
    ## The task begins to encompass the scripter
    ## To run circles 'cross his mind.
    ## Simple commands that run awry - segmentation faults deep into the night.
#######################################################################################################
# Fix open issue if appropriate
#######################################################################################################
## Text pulsing green
    ## Envy of a windows admin (who can't spell keyboard).
        ## The Solaris box laughing
            ## Savoring the keystrokes of a pending kernel panic.
            ## Only a heightened sense of things.
                ## The Dr. Pepper at his side
                    ## An alabaster tan.
                    ## His hands are steady.
                    ## His syntax: Perfect.
                    ## And so the scripter, given up as a lost cause
                    ## Finishes his task, and returns to his people.
                    ## In the IT circles, a king.
                    ## A unix admin.
            ## Modern day Leonidas!
                ## It's been more than 40 years
                ## Since the inception of proprietary code
                ## Now as then, the beast approaches.
            ## Patient and confident, savoring the out-sourcing to come
            ## The beast is made of men and dollar signs - corporate lawyers and venture capitalists
            ## An army of Overseers, rich beyond imagining.
    ## Ready to snuff out non-compiled code, any hope for sharing and openness.
## This beast approaches, hiding behind proprietary automation and ease of use.
## It was freedom itself that provoked it.
1 Like

It probably should have been posted in the Lounge.

Regards,
Alister

1 Like

Good point, moving it.

1 Like