revised doc for combined functions