added documentation, removed obsolet methods