Swift 6.1.2

This release updates Unidoc to support Swift 6.1

There are three features added in Unidoc 0.21.0.

• Declarations that are overloaded on async can now be disambiguated in the UCF syntax with [async], or [async: false] to select the non-async overload.
• Unidoc can now conditionally ignore broken symbol links using the [ignore when: SOME_DEFINITION] syntax, which can be combined with --define SOME_DEFINITION passed to unidoc compile. This is most useful for CI workflows that attempt to validate documentation that includes links to symbols that only exist on certain platforms.
• You can now print the tool version with unidoc --version

Full Changelog: 0.20.1...0.21.0

What's Changed

• Unidoc now supports type signature based link disambiguation, allowing you to distinguish between different overloads on the same base name.
• Unidoc now supports Package Themes, which can be selected under Package Settings and take effect instantly (#364)
• In the list of package consumers, Unidoc now displays the version (git tag) associated with the most recent release of the downstream package (#356)
• Clicking on a sidebar link to an extended type now scrolls you directly to that module’s extensions instead of depositing you at the top of the page (#374)
• Unidoc can now (lazily) generate redirects to historical documentation when API is removed in a subsequent release. The redirect is available if at least one trustworthy client (Googlebot, Bingbot, or a logged-in user) had visited the deleted page before the symbol was removed (#358, #361)
• Unidoc now records the git commit date in the binary symbol graph format, if known (#371)
• Unidoc now prefers non-inherited symbols when disambiguating symbol links and breaks ties by preferring the symbol with more documentation (#381)
• Plugin logs can now be viewed through the HTML UI (#363)
• Unidoc can now be built in distributed configuration, with creating binaries for frontend and backend servers (#367)
• Adds a utility command unidoc list-assets (#370)
• Unidoc now compresses symbol graphs before uploading them to a server (#354)

Notable Bugfixes

• Deduplicate macro synthesized decls (#352)
• Ignore validation errors resulting from swiftlang/swift#76877 (#353)
• Multi-column DocC layouts no longer overflow their parent containers (#390)

Full Changelog: 0.19.6...0.20.0

What's Changed

• Improved the ergonomics of the unidoc local command — it will now build the SwiftPM project in the current working directory if given no arguments, or the package specified by -i/--project-path if supplied.
• Added an overload disambiguation heuristic that automatically selects the documented overload, if exactly one overload among the choices has an associated doccomment and none of the others do.
• Trailing parentheses in symbol links are now meaningful, and will exclude struct, enum, class, actor, typealias, protocol, associatedtype, deinit, and var declarations.
• The absence of trailing parentheses in symbol links is now meaningful, and will exclude macro declarations only.

Full Changelog: 0.19.5...0.19.6

This release fixes a regression introduced in 0.19.4, in which @_exported symbols would cause false positives in the ambiguous symbol link checker, if the fully-qualified symbol link written spans three or more modules that re-export one another.

What's Changed

• fix module name shadowing problem preventing compiling Unidoc itself on macOS Sequoia by @tayloraswift in #344
• enable writing codelinks that resolve through @_exported paths and serve HTTP redirects for @_exported symbols by @tayloraswift in #345
• add definitions for bridgeOS and add missing Swift 6 stdlib modules to the standard library recipe by @tayloraswift in #347

Full Changelog: 0.19.3...0.19.4

This release makes the project compile with Swift 6.0.

This release also enables using Swift 6.0 as the compiler backend for building packages (this is different from compiling Unidoc itself!) and also disables several Unidoc assertions that collide with known regressions in the Swift 6.0 compiler.

• swiftlang/swift#76499
• swiftlang/swift#76559

Please note, on macOS, using a downloadable non-Xcode 6.0 toolchain as a package compiler backend is not recommended. In particular, you are likely to run into swiftlang/swift#76561 !

This release fixes a bug that caused SwiftPM packages that use uppercase letters in their project directory names to fail to compile on case-sensitive file systems.

Full Changelog: 0.19.1...0.19.2

What's Changed

• Optimized dynamic linker for Symbol Graphs with ABI ≥ 0.11.0
• Add support for visionOS @available markers