documentation fixes and dimensional == 1 replaced