updated some method descriptions