add more notes on building
clean up some variable names and printf