major documentation update of vol2lib