some more documenting; unused method removed