log warnings, added documentation comment