update nonlinear.rst and associated doc files