includes comments for most methods.