more error info; add doc