diff --git a/doc/api.md b/doc/api.md index 48123f1cb..2847b4c06 100644 --- a/doc/api.md +++ b/doc/api.md @@ -345,7 +345,8 @@ A tuple of `(CcLinkingContext, CcLinkingOutputs)` containing the linking ## swift_common.create_module
-swift_common.create_module(name, clang, compilation_context, is_system, swift)
+swift_common.create_module(name, clang, const_gather_protocols, compilation_context, is_system,
+                           swift)
 
Creates a value containing Clang/Swift module artifacts of a dependency. @@ -374,6 +375,7 @@ the set of transitive module names that are propagated by dependencies | :------------- | :------------- | :------------- | | name | The name of the module. | none | | clang | A value returned by `swift_common.create_clang_module` that contains artifacts related to Clang modules, such as a module map or precompiled module. This may be `None` if the module is a pure Swift module with no generated Objective-C interface. | `None` | +| const_gather_protocols | A list of protocol names from which constant values should be extracted from source code that takes this module as a *direct* dependency. | `[]` | | compilation_context | A value returned from `swift_common.create_compilation_context` that contains the context needed to compile the module being built. This may be `None` if the module wasn't compiled from sources. | `None` | | is_system | Indicates whether the module is a system module. The default value is `False`. System modules differ slightly from non-system modules in the way that they are passed to the compiler. For example, non-system modules have their Clang module maps passed to the compiler in both implicit and explicit module builds. System modules, on the other hand, do not have their module maps passed to the compiler in implicit module builds because there is currently no way to indicate that modules declared in a file passed via `-fmodule-map-file` should be treated as system modules even if they aren't declared with the `[system]` attribute, and some system modules may not build cleanly with respect to warnings otherwise. Therefore, it is assumed that any module with `is_system == True` must be able to be found using import search paths in order for implicit module builds to succeed. | `False` | | swift | A value returned by `swift_common.create_swift_module` that contains artifacts related to Swift modules, such as the `.swiftmodule`, `.swiftdoc`, and/or `.swiftinterface` files emitted by the compiler. This may be `None` if the module is a pure C/Objective-C module. | `None` |