document solvers and options. closes #39