some refactoring
- tabs for indenting, spaces for alignment!
- added more info to notes about new object interface items