more precise log message
added doc
subtracted accidentally merged in diff from gplay branch