I agree with Bruce that having a link to
https://petsc.org/release/manual/fortran/ at the top of the C/Fortran
API page (https://petsc.org/release/manualpages/) would be helpful.
The C descriptions themselves are 98% of the way there for Fortran users
(like myself). The only time that more information would be help on the
manual pages themselves is when there
is a strong variance between the C and Fortran usage, but that can not
be easily automated.
-sanjay
On 12/12/23 9:07 AM, Barry Smith wrote:
It is unlikely we will ever be able to maintain full manual pages
for Fortran for all routines. But yes, the current pages are C-centric.
Do you have any suggestions on what we could add to the current
manual pages or how to format them etc that would make them better for
Fortran users who are not used to C? A Fortran synopsis as well as
the C one, or a single synopsis that is easier for both Fortran and C
users to follow?
Barry
I am not sure it is trivial to automatically generate the Fortran
synposis with appropriate use and include information but one could
argue that we should.
On Dec 12, 2023, at 11:40 AM, Palmer, Bruce J via petsc-users
<petsc-users@mcs.anl.gov> wrote:
Thanks! It might be useful if there were a link to this page near the
top of the C/Fortran API page.
Bruce
*From:*Matthew Knepley <knep...@gmail.com>
*Date:*Tuesday, December 12, 2023 at 8:33 AM
*To:*Palmer, Bruce J <bruce.pal...@pnnl.gov>
*Cc:*petsc-users@mcs.anl.gov<petsc-users@mcs.anl.gov>
*Subject:*Re: [petsc-users] Fortran Interface
Check twice before you click! This email originated from outside PNNL.
On Tue, Dec 12, 2023 at 11:27 AM Palmer, Bruce J via petsc-users
<petsc-users@mcs.anl.gov> wrote:
Does documentation for the PETSc fortran interface still exist? I
looked at the web pages for 3.20 (petsc.org/release
<http://petsc.org/release>) but if you go under the tab C/Fortran
API, only descriptions for the C interface are there.
I think after the most recent changes, the interface was supposed to
be very close to C, so we just document the differences on specific
pages, and put the general stuff here:
https://petsc.org/release/manual/fortran/
Thanks,
Matt
Bruce Palmer
--
What most experimenters take for granted before they begin their
experiments is infinitely more interesting than any results to which
their experiments lead.
-- Norbert Wiener
https://www.cse.buffalo.edu/~knepley/
<http://www.cse.buffalo.edu/~knepley/>
