upd : new function and doc

New functionality added.
Documentation created.