update missing variable declaration

... and docblock updates