added docs for 'main' variables