enhanced doc and fixed bugs in super block library