added documentation for first exported function