updated function docs in README