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.