improved global variable commentary