fix #28 - finish documentation for bsp 1