documented new query