added documentation on bb() parameters