Generate docsets for Xcode

[jpsim]

No description provided.

[segiddins]

@Kapeli do you know of any resources that describe what's necessary?

[Kapeli]

Nope, sorry. The process is pretty much: generate a Nodes.xml and a Tokens.xml and then run "docsetutil" over it, which is a command line tool bundled with Xcode.

If you generate a docset using appledoc, you should see how it sets up these files and maybe replicate what it's doing?

[pigeon-archive]

What's the status on this? From my understanding this has already been completed?

[1ec5]

No, jazzy doesn't generate Xcode docsets yet.

[pigeon-archive]

My apologies. Thanks for the response @1ec5. Misunderstood.

[jpsim]

@istx25 note the difference between a "Dash" docset and an Xcode docset. They're different formats.

[pigeon-archive]

Yup! My apologies.

[1ec5]

appledoc splits the Xcode docset generation process into three steps:

https://github.com/tomaz/appledoc/blob/12dd17471508624bd9d0b0006aa5d9da9959cc0f/Generating/GBDocSetOutputGenerator.m
https://github.com/tomaz/appledoc/blob/12dd17471508624bd9d0b0006aa5d9da9959cc0f/Generating/GBDocSetInstallGenerator.m
https://github.com/tomaz/appledoc/blob/12dd17471508624bd9d0b0006aa5d9da9959cc0f/Generating/GBDocSetPublishGenerator.m

[1ec5]

From the Xcode 8.3 release notes:

3rd party docset support is now deprecated and will no longer be supported in a future release of Xcode. (30584489)

[jpsim]

Well that keeps things simple!