<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
<body>
I agree with Bruce that having a link to
<a class="moz-txt-link-freetext" href="https://petsc.org/release/manual/fortran/">https://petsc.org/release/manual/fortran/</a> at the top of the
C/Fortran API page (<a class="moz-txt-link-freetext" href="https://petsc.org/release/manualpages/">https://petsc.org/release/manualpages/</a>) 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<br>
is a strong variance between the C and Fortran usage, but that can
not be easily automated.<br>
<pre class="moz-signature" cols="72">-sanjay
</pre>
<div class="moz-cite-prefix">On 12/12/23 9:07 AM, Barry Smith wrote:<br>
</div>
<blockquote type="cite"
cite="mid:B0631191-BBBA-49DB-855A-46285057EE5B@petsc.dev">
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<div><br>
</div>
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.
<div><br>
</div>
<div> 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?</div>
<div><br>
</div>
<div> Barry</div>
<div><br>
</div>
<div>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.</div>
<div><br>
</div>
<div><br id="lineBreakAtBeginningOfMessage">
<div><br>
<blockquote type="cite">
<div>On Dec 12, 2023, at 11:40 AM, Palmer, Bruce J via
petsc-users <a class="moz-txt-link-rfc2396E" href="mailto:petsc-users@mcs.anl.gov"><petsc-users@mcs.anl.gov></a> wrote:</div>
<br class="Apple-interchange-newline">
<div>
<meta charset="UTF-8">
<div class="WordSection1"
style="page: WordSection1; caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 18px; font-style: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;">
<div
style="margin: 0in; font-size: 10pt; font-family: Calibri, sans-serif;"><span
style="font-size: 11pt;">Thanks! It might be useful
if there were a link to this page near the top of
the C/Fortran API page.<o:p></o:p></span></div>
<div
style="margin: 0in; font-size: 10pt; font-family: Calibri, sans-serif;"><span
style="font-size: 11pt;"><o:p> </o:p></span></div>
<div
style="margin: 0in; font-size: 10pt; font-family: Calibri, sans-serif;"><span
style="font-size: 11pt;">Bruce<o:p></o:p></span></div>
<div
style="margin: 0in; font-size: 10pt; font-family: Calibri, sans-serif;"><span
style="font-size: 11pt;"><o:p> </o:p></span></div>
<div id="mail-editor-reference-message-container">
<div>
<div
style="border-width: 1pt medium medium; border-style: solid none none; border-color: rgb(181, 196, 223) currentcolor currentcolor; border-image: none; padding: 3pt 0in 0in;">
<p class="MsoNormal"
style="margin: 0in 0in 12pt; font-size: 10pt; font-family: Calibri, sans-serif;"><b><span
style="font-size: 12pt;">From:<span
class="Apple-converted-space"> </span></span></b><span
style="font-size: 12pt;">Matthew Knepley <<a
href="mailto:knepley@gmail.com"
style="color: blue; text-decoration: underline;" moz-do-not-send="true"
class="moz-txt-link-freetext">knepley@gmail.com</a>><br>
<b>Date:<span class="Apple-converted-space"> </span></b>Tuesday,
December 12, 2023 at 8:33 AM<br>
<b>To:<span class="Apple-converted-space"> </span></b>Palmer,
Bruce J <<a
href="mailto:Bruce.Palmer@pnnl.gov"
style="color: blue; text-decoration: underline;" moz-do-not-send="true"
class="moz-txt-link-freetext">Bruce.Palmer@pnnl.gov</a>><br>
<b>Cc:<span class="Apple-converted-space"> </span></b><a
href="mailto:petsc-users@mcs.anl.gov"
style="color: blue; text-decoration: underline;" moz-do-not-send="true"
class="moz-txt-link-freetext">petsc-users@mcs.anl.gov</a><span
class="Apple-converted-space"> </span><<a
href="mailto:petsc-users@mcs.anl.gov"
style="color: blue; text-decoration: underline;" moz-do-not-send="true"
class="moz-txt-link-freetext">petsc-users@mcs.anl.gov</a>><br>
<b>Subject:<span class="Apple-converted-space"> </span></b>Re:
[petsc-users] Fortran Interface<o:p></o:p></span></p>
</div>
<div
style="border-width: medium medium medium 6pt; border-style: none none none solid; border-color: currentcolor currentcolor currentcolor rgb(215, 118, 0); border-image: none; padding: 0in; font-size: 1.15rem;">
<div
style="margin: 0in; font-size: 10pt; font-family: Calibri, sans-serif; text-align: center; background: rgb(247, 227, 204);"><span
style="font-size: 11pt; font-family: Arial, sans-serif;">Check twice
before you click! This email originated from
outside PNNL.</span><span
style="font-size: 11pt; font-family: Arial, sans-serif;"><o:p></o:p></span></div>
</div>
<div
style="margin: 0in; font-size: 10pt; font-family: Calibri, sans-serif;"><span
style="font-size: 11pt;"><o:p> </o:p></span></div>
<div>
<div>
<div>
<div
style="margin: 0in; font-size: 10pt; font-family: Calibri, sans-serif;"><span
style="font-size: 11pt;">On Tue, Dec 12,
2023 at 11:27 AM Palmer, Bruce J via
petsc-users <<a
href="mailto:petsc-users@mcs.anl.gov"
style="color: blue; text-decoration: underline;" moz-do-not-send="true"
class="moz-txt-link-freetext">petsc-users@mcs.anl.gov</a>>
wrote:<o:p></o:p></span></div>
</div>
<div>
<blockquote
style="border-width: medium medium medium 1pt; border-style: none none none solid; border-color: currentcolor currentcolor currentcolor rgb(204, 204, 204); border-image: none; padding: 0in 0in 0in 6pt; margin-left: 4.8pt; margin-right: 0in;">
<div>
<div>
<div>
<div
style="margin: 0in; font-size: 10pt; font-family: Calibri, sans-serif;"><span
style="font-size: 11pt;">Does
documentation for the PETSc
fortran interface still exist? I
looked at the web pages for 3.20 (<a
href="http://petsc.org/release"
target="_blank"
style="color: blue; text-decoration: underline;" moz-do-not-send="true">petsc.org/release</a>)
but if you go under the tab
C/Fortran API, only descriptions
for the C interface are there.<o:p></o:p></span></div>
</div>
</div>
</div>
</blockquote>
<div>
<div
style="margin: 0in; font-size: 10pt; font-family: Calibri, sans-serif;"><span
style="font-size: 11pt;"><o:p> </o:p></span></div>
</div>
<div>
<div
style="margin: 0in; font-size: 10pt; font-family: Calibri, sans-serif;"><span
style="font-size: 11pt;">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:<o:p></o:p></span></div>
</div>
<div>
<div
style="margin: 0in; font-size: 10pt; font-family: Calibri, sans-serif;"><span
style="font-size: 11pt;"><o:p> </o:p></span></div>
</div>
<div>
<div
style="margin: 0in; font-size: 10pt; font-family: Calibri, sans-serif;"><span
style="font-size: 11pt;"> <a
href="https://petsc.org/release/manual/fortran/"
style="color: blue; text-decoration: underline;" moz-do-not-send="true"
class="moz-txt-link-freetext">https://petsc.org/release/manual/fortran/</a><o:p></o:p></span></div>
</div>
<div>
<div
style="margin: 0in; font-size: 10pt; font-family: Calibri, sans-serif;"><span
style="font-size: 11pt;"><o:p> </o:p></span></div>
</div>
<div>
<div
style="margin: 0in; font-size: 10pt; font-family: Calibri, sans-serif;"><span
style="font-size: 11pt;"> Thanks,<o:p></o:p></span></div>
</div>
<div>
<div
style="margin: 0in; font-size: 10pt; font-family: Calibri, sans-serif;"><span
style="font-size: 11pt;"><o:p> </o:p></span></div>
</div>
<div>
<div
style="margin: 0in; font-size: 10pt; font-family: Calibri, sans-serif;"><span
style="font-size: 11pt;"> Matt<o:p></o:p></span></div>
</div>
<div>
<div
style="margin: 0in; font-size: 10pt; font-family: Calibri, sans-serif;"><span
style="font-size: 11pt;"> <o:p></o:p></span></div>
</div>
<blockquote
style="border-width: medium medium medium 1pt; border-style: none none none solid; border-color: currentcolor currentcolor currentcolor rgb(204, 204, 204); border-image: none; padding: 0in 0in 0in 6pt; margin-left: 4.8pt; margin-right: 0in;">
<div>
<div>
<div>
<div
style="margin: 0in; font-size: 10pt; font-family: Calibri, sans-serif;"><span
style="font-size: 11pt;">Bruce
Palmer<o:p></o:p></span></div>
</div>
</div>
</div>
</blockquote>
</div>
<div
style="margin: 0in; font-size: 10pt; font-family: Calibri, sans-serif;"><span
style="font-size: 11pt;"><br clear="all">
<o:p></o:p></span></div>
<div>
<div
style="margin: 0in; font-size: 10pt; font-family: Calibri, sans-serif;"><span
style="font-size: 11pt;"><o:p> </o:p></span></div>
</div>
<div
style="margin: 0in; font-size: 10pt; font-family: Calibri, sans-serif;"><span
class="gmailsignatureprefix"><span
style="font-size: 11pt;">--</span></span><span
style="font-size: 11pt;"><o:p></o:p></span></div>
<div>
<div>
<div>
<div>
<div>
<div>
<div>
<div
style="margin: 0in; font-size: 10pt; font-family: Calibri, sans-serif;"><span
style="font-size: 11pt;">What
most experimenters take for
granted before they begin
their experiments is
infinitely more interesting
than any results to which
their experiments lead.<br>
-- Norbert Wiener<o:p></o:p></span></div>
</div>
<div>
<div
style="margin: 0in; font-size: 10pt; font-family: Calibri, sans-serif;"><span
style="font-size: 11pt;"><o:p> </o:p></span></div>
</div>
<div>
<div
style="margin: 0in; font-size: 10pt; font-family: Calibri, sans-serif;"><span
style="font-size: 11pt;"><a
href="http://www.cse.buffalo.edu/~knepley/" target="_blank"
style="color: blue; text-decoration: underline;" moz-do-not-send="true">https://www.cse.buffalo.edu/~knepley/</a></span></div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</blockquote>
</div>
<br>
</div>
</blockquote>
<br>
</body>
</html>