language fixes in the API documentation

this is similar to r10476 of Dumux, but with some additional fixes.