Poprawa dokumentacji + dopisanie algorytmów

jw.