doc + deduplicate code

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