updated docs...

Signed-off-by: Alex A. Naanou <alex.nanou@gmail.com>
refactored marks a bit + fixed a minor bug...

Signed-off-by: Alex A. Naanou <alex.nanou@gmail.com>