Some cosmetic fixes and a bit more documentation

Signed-off-by: Clement Escoffier <clement.escoffier@gmail.com>