blanketed whole script with documentation in hopes it will ever be useful to anyone else ever