caio/clang-p2996
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

[flang][docs] Document technique for regenerating a module hermetically (#139975)

Browse Source 
A flang-new module file is Fortran source, so it can be recompiled with
the `-fhermetic-module-files` option to convert it into a hermetic one.
This commit is contained in:
Peter Klausler
2025-05-15 11:26:21 -07:00
committed by GitHub
parent c26e7520a9
commit b7e13ab429
1 changed files with 11 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
flang/docs/ModFiles.md
View File

@@ -171,3 +171,14 @@ modules of dependent libraries need not also be packaged with the library.
When the compiler reads a hermetic module file, the copies of the dependent
modules are read into their own scope, and will not conflict with other modules
of the same name that client code might `USE`.
One can use the `-fhermetic-module-files` option when building the top-level
module files of a library for which not all of the implementation modules
will (or can) be shipped.
It is also possible to convert a default module file to a hermetic one after
the fact.
Since module files are Fortran source, simply copy the module file to a new
temporary free form Fortran source file and recompile it (`-fsyntax-only`)
with the `-fhermetic-module-files` flag, and that will regenerate the module
file in place with all of its dependent modules included.