document new null-friendly functions