make helper function private
additional doc fixes