Cross-link to external docsets

[jpsim]

[jpsim]

Linking to Apple's docs and other projects should be possible, but will likely be a fairly difficult task.

[segiddins]

If you get the module that an external symbol refers to, this might be possible in cocoadocs

[jpsim]

Agreed.

[istx25]

What's the progress on this?

[jpsim]

No one's done any work on this as far as I can tell.

[1ec5]

Invoking a command like this:

xcrun docsetutil search -skip-text -query CLLocation ~/Library/Developer/Shared/Documentation/DocSets/com.apple.adc.documentation.iOS.docset

yields output like this:

 Swift/cl/-/CLLocation   documentation/CoreLocation/Reference/CLLocation_Class/index.html#//apple_ref/swift/cl/c:objc(cs)CLLocation
 Objective-C/cl/-/CLLocation   documentation/CoreLocation/Reference/CLLocation_Class/index.html#//apple_ref/occ/cl/CLLocation

We can construct a URL based on one of these file path–apple_ref combinations:

https://developer.apple.com/documentation/CoreLocation/Reference/CLLocation_Class/index.html#//apple_ref/occ/cl/CLLocation

which redirects to:

https://developer.apple.com/reference/corelocation/cllocation#//apple_ref/occ/cl/CLLocation

The query can be the name of a class, method, etc., but the redirect for a method only goes to the class reference. We can specify multiple symbols at a time, separated by spaces.

[jpsim]

Nice finds @1ec5!