I found this new issue when I developed a framework for a client. I have all Swift code in a module and added good documentation comments to all public methods and features.
In Xcode 8, you can open + click any property, class or method, and you will see the documentation from these comments. This would work regardless of whether you are in Swift or Objective-C.
Now with Xcode 9 that does not suddenly no longer work from the Objective-C code. In Swift files, it still works, both in the module itself and in an app that imports it.
Filed as rdar: // 34789767 and on Open Radar. The mentioned sample is on my Radar Samples GitHub repo, titled InterfaceTest.
Documentation comments for a Swift class are shown only within the Swift code. Neither in the same module nor in an import ObjC class Quick Help works. The generated ObjC Header
Module-Swift.h has the documentation comments. [1
- Open ObjcCViewController.m or the trial application with Xcode 9
- You must see "This is a public property" that appears in Quick Help
- ] You only see "No quick help"
- If you do the same in SwiftViewController see Quick Help as expected.
Version / Build
Version 9.0 (9A235)
iMac or MacBook, with Xcode 9 and MacOS 10.13
Also published on Medium.
Categories: Error Reports