[committed] Fortran: Add more documentation for mixed-language programming
Commit Message
I was recently pinged about PR35276. It's an old issue, but a couple of
the concerns raised there haven't been fixed yet, so I've checked in
this patch to fill in the gaps.
-Sandra
Comments
Hi Sandra,
Looks good to me.
Thanks
Paul
On Fri, 5 Nov 2021 at 21:13, Sandra Loosemore <sandra@codesourcery.com>
wrote:
> I was recently pinged about PR35276. It's an old issue, but a couple of
> the concerns raised there haven't been fixed yet, so I've checked in
> this patch to fill in the gaps.
>
> -Sandra
>
commit b8bf685ed44dba9bd4bbd600bc8bc2be0a2abb1b
Author: Sandra Loosemore <sandra@codesourcery.com>
Date: Fri Nov 5 14:01:03 2021 -0700
Fortran: Add more documentation for mixed-language programming [PR35276]
2021-11-05 Sandra Loosemore <sandra@codesourcery.com>
PR fortran/35276
gcc/fortran/
* gfortran.texi (Mixed-Language Programming): Talk about C++,
and how to link.
@@ -2718,11 +2718,23 @@ reading from the position marked previously.
* Naming and argument-passing conventions::
@end menu
-This chapter is about mixed-language interoperability, but also applies
-if one links Fortran code compiled by different compilers. In most cases,
-use of the C Binding features of the Fortran 2003 standard is sufficient,
-and their use is highly recommended.
-
+This chapter is about mixed-language interoperability, but also
+applies if you link Fortran code compiled by different compilers. In
+most cases, use of the C Binding features of the Fortran 2003 and
+later standards is sufficient.
+
+For example, it is possible to mix Fortran code with C++ code as well
+as C, if you declare the interface functions as @code{extern "C"} on
+the C++ side and @code{BIND(C)} on the Fortran side, and follow the
+rules for interoperability with C. Note that you cannot manipulate
+C++ class objects in Fortran or vice versa except as opaque pointers.
+
+You can use the @command{gfortran} command to link both Fortran and
+non-Fortran code into the same program, or you can use @command{gcc}
+or @command{g++} if you also add an explicit @option{-lgfortran} option
+to link with the Fortran library. If your main program is written in
+C or some other language instead of Fortran, see
+@ref{Non-Fortran Main Program}, below.
@node Interoperability with C
@section Interoperability with C