docs "b" funcs

first pass on functions starting with "B", starting to figure out doc strings in general, will have to go over this section again in the future.
Merge pull request #72 from AndrewAnnex/docs_b_funcs

docs "b" funcs