document and reduce code

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