Improve discussions of Fortran in API docs, in particular adding very useful...

See https://petsc.gitlab.io/-/petsc/-/jobs/5739238224/artifacts/public/html/manual/fortran.html#ch-fortran for the new text

Reported-by: Bruce J. Palmer