add notes on list variable function