Skip to content

update SymbolKit to include apple/swift-docc-symbolkit#44 #326

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Jul 1, 2022

Conversation

QuietMisdreavus
Copy link
Contributor

@QuietMisdreavus QuietMisdreavus commented Jun 30, 2022

Bug/issue #, if applicable: rdar://96216773

Summary

When #314 was added, it didn't include all the relevant changes to SymbolKit. Specifically, it didn't include swiftlang/swift-docc-symbolkit#44, which handles decoding ill-formatted URLs that include unescaped spaces. This caused a failure when building documentation for swift-argument-parser, which uses spaces in its source directories.

I've also added tests that ensure that doc comment file paths that include spaces in the JSON properly decode without error.

Dependencies

None (the relevant change has already been merged)

Testing

Build documentation with symbol graphs that use spaces in their file names, e.g. swift-argument-parser.

Steps:

  1. Clone ArgumentParser, if you haven't already.
  2. Build Swift-DocC with this change.
  3. With Xcode 14 Beta or higher, run xcodebuild clean docbuild -scheme ArgumentParser -destination platform=macOS DOCC_EXEC=/path/to/swift-docc/.build/debug/docc
  4. Make sure that Swift-DocC builds documentation successfully.

Checklist

Make sure you check off the following items. If they cannot be completed, provide a reason.

  • Added tests
  • Ran the ./bin/test script and it succeeded
  • [ n/a ] Updated documentation if necessary

@QuietMisdreavus
Copy link
Contributor Author

@swift-ci Please test

@QuietMisdreavus
Copy link
Contributor Author

@swift-ci Please test

@QuietMisdreavus QuietMisdreavus merged commit 8156ed0 into swiftlang:main Jul 1, 2022
@QuietMisdreavus QuietMisdreavus deleted the comment-spaces branch July 1, 2022 16:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants