Some doc and tweaking.

This is the "tested" version. Managed to block the tight loop in the
archiver