document algorithms

Signed-off-by: Mattias Andrée <maandree@operamail.com>