documentation and slight syntax changes in creation of random effects structure