better documentation

added space between params and result in docs; \_private\_ functions' names are no longer _italic_