document external functions