@@ -100,15 +100,23 @@ generated by the script:
100
100
The Fortran file ``api_f08_generated.F90 `` contains all the internal subroutine
101
101
definitions, each of which makes a call into corresponding C functions. Two
102
102
different C files are generated: ``api_f08_ts_generated.c `` contains support
103
- for compilers with TS 29113 support, allowing the use of ``CFI_cdesc_t `` types;
104
- and ``api_f08_generated.c `` for compilers without TS 29113 support. The
105
- internal subroutine names are mapped to the external interface, including
106
- multiple interfaces for the bigcount version of functions, in
107
- ``mpi-f08-interfaces-generated.h ``.
103
+ for compilers with TS 29113 support, allowing the use of ``CFI_cdesc_t `` types
104
+ (see `Fortran 2018 `_ for more details); and ``api_f08_generated.c `` for
105
+ compilers without TS 29113 support. The internal subroutine names are mapped to
106
+ the external interface, including multiple interfaces for the bigcount version
107
+ of functions, in ``mpi-f08-interfaces-generated.h ``.
108
+
109
+ .. _Fortran 2018 : https://fortranwiki.org/fortran/show/Fortran+2018
108
110
109
111
If a new type needs to be added, then one will need to extend
110
112
``fortran_type.py `` in ``ompi/mpi/bindings/ompi_bindings `` with an additional
111
113
type class specifying how to handle the type in the above generated files,
112
114
including any required key-value attributes for more complicated types. New
113
115
types use a ``Type `` base class with functions that can be implemented by
114
116
derived classes, each returning expanded Fortran or C code.
117
+
118
+ Other Considerations
119
+ --------------------
120
+
121
+ Keep in mind that the generated files will not be deleted with a ``make clean ``
122
+ or ``make distclean ``; instead use ``make maintainer-clean `` to delete those.
0 commit comments