How to add Sparrow documentation in XCode 5 ?

bobmoff

I tried following the instruction for setting up the project and one of the first steps i to enable documentation support in XCode, but it seems there have been a change from XCode 4 to 5, coz I cant find where to add the documentation URL ?

Shilo

I was unable to find any details on this Xcode change, but I have a solution.

In Xcode 5, It seems you have to manually add the .docset file into the "_{/Library/Developer/Shared/Documentation/DocSets".} Alternatively you can use an application named "Docs for Xcode", to add the docset via the feed "http://doc.sparrow-framework.org/core/feed/docset.atom", which can be found here: http://documancer.com/xcode/

I used the above application and successfully installed Sparrow's docset for Xcode 5. The application does require OS X 10.8, so if you don't meet that requirement, I can share the docset file or possibly create a script to download the docset and install it, just as the application does.

Shilo

Here are the terminal commands to install the documentation manually:

cd ~/Library/Developer/Shared/Documentation/DocSets
curl -O "http://doc.sparrow-framework.org/core/feed/com.gamua.Sparrow-Framework-2.0.xar"
xar -x -f "com.gamua.Sparrow-Framework-2.0.xar"
rm "com.gamua.Sparrow-Framework-2.0.xar"

"curl -O" command will download the xar archive from the remote server into the /DocSet/ directory.
"xar -x -f" command will extract the files from the xar archive.
"rm" command will delete the xar archive.

Or if you may download my script, which does the same commands and outputs a success or failed log. Script is located here: https://gist.github.com/Shilo/6956594

Daniel

Thanks for the heads-up, guys! I have updated the relevant wiki document right now and will update the texts on gamua.com in the next few days.