self documenting hints with empty define macros
add labels to input/output variables
style update