documentation for new solver api in header