add notes about these functions which are not useful to the general public