added usage comments and notes