DOC: better warning messages