realm / jazzy

Soulful docs for Swift & Objective-C
https://realm.io
MIT License
7.35k stars 413 forks source link

Symbolgraph extension symbols #1372

Closed johnfairh closed 1 year ago

johnfairh commented 1 year ago

Support the opt-in symbolgraph extension symbols for Swift 5.9.

These are for extensions from other modules only, extensions in the same module don't get these symbols. I've turned on the option for the test case because it runs on Swift 5.9 and exercises all the new paths -- looks good, grabs a bunch more information for those extensions including doc comments.

johnfairh commented 1 year ago

This all seems to work well.

Jazzy itself needs to support pre-5.9 swift so it does not set -emit-extension-block-symbols when asked to generate symbolgraphs itself. The user can override this if necessary as done in the test runner - we could be smarter I suppose.

Also fixes a couple of bugs:

Fixes #1368