documentation on common functions