problem with editor spitting out undefined
alan's tricky masking bug
some documentation tweaking