fix docblock inaccuracy
address some debug "pass by reference" errors