document some variables