added documentation to BitArray functions