usability changes (see details) and doc cleanup

- properties display flag conveniently in constructor
- properties can be exposed as arrays