docs and code tidying
ABoioleanMatrix overrides
misc edits
extra validation
extra overrides