Support extension blocks in DocC rule #2445
Comments
luispadron
changed the title
This was referenced Apr 10, 2024
luispadron
added a commit
to bazelbuild/rules_swift
that referenced
this issue
Jun 20, 2024
The `emit_extension_block_symbols` attr can be used in the `swift_extract_symbol_graph` rule to pass the `-emit-extension-block-symbols` flag when creating the symbol graphs. This enables generating symbol graph information for extensions of custom types. This is required to support bazelbuild/rules_apple#2445
sewerynplazuk
pushed a commit
to sewerynplazuk/rules_apple
that referenced
this issue
Sep 20, 2024
Updates the DocC rules to support rules_swift 2.x which introduced breaking changes to how Swift symbol graphs are collected. This PR updates to use the new aspect to extract the symbol graphs. The public API remains unchanged. Fixes bazelbuild#2445
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
With Xcode 15+ it's possible to generate documentation using DocC for extensions as well (e.g. code in an
extensionblock).This is enabled in Xcode via the
DOCC_EXTRACT_EXTENSION_SYMBOLSXcode configuration variable. For Bazel, we'd likely need to update the rule which currently emits symbol graphs to pass an additional flag to also emit the symbols for extension blocks.SPM uses these flags: https://github.com/apple/swift-package-manager/blob/main/Sources/Commands/Utilities/SymbolGraphExtract.swift#L86
-emit-extension-block-symbols-omit-extension-block-symbolsThe text was updated successfully, but these errors were encountered: