More doc updates - add notes on foreach.