mention limitation of algorithm in dox
(#601)