even more comments and reformatting code for readability
even more comments and reformatting code for readability

sean-/nad,HeinrichHartmann/nad,maier/nad,HeinrichHartmann/nad,HeinrichHartmann/nad,hjhart/nad,hjhart/nad,sean-/nad,sean-/nad,esproul/nad,circonus-labs/nad,esproul/nad,HeinrichHartmann/nad,circonus-labs/nad,HeinrichHartmann/nad,maier/nad,circonus-labs/nad,keithf4/nad,keithf4/nad,esproul/nad,circonus-labs/nad,keithf4/nad,maier/nad,hjhart/nad,esproul/nad,sean-/nad,sean-/nad,hjhart/nad,keithf4/nad,circonus-labs/nad,esproul/nad,keithf4/nad,maier/nad,HeinrichHartmann/nad,hjhart/nad,circonus-labs/nad,maier/nad,maier/nad