made input descriptions more detailed; added comments