bazelbuild / rules_apple

Bazel rules to build apps for Apple platforms.
Apache License 2.0
512 stars 269 forks source link

Support extension blocks in DocC rule #2445

Closed luispadron closed 4 months ago

luispadron commented 7 months ago

With Xcode 15+ it's possible to generate documentation using DocC for extensions as well (e.g. code in an extension block).

This is enabled in Xcode via the DOCC_EXTRACT_EXTENSION_SYMBOLS Xcode 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